Error unregistering runner from GitLab forbidden with docker executor: Fatal failed to unregister runner


GitLab Runner is an application that works with GitLab CI/CD to run jobs in a pipeline. GitLab Runner is open-source and written in Go. It can be run as a single binary; no language-specific requirements are needed. GitLab Runner can also run inside a Docker container or be deployed into a Kubernetes cluster. Below are some GitLab related contents you may be interested in: How to install, register and start GitLab Runner on Windows, how to uninstall GitLab from your Windows device, Deploying and using Windows containers with Gitlab CI, how to manually update Docker desktop, and how to install and uninstall Docker Desktop on Windows 10 and Windows Server.

Why you should use GitLab: GitLab enables team members to collaborate in every phase of the project. GitLab offers tracking from planning to creation to help developers automate the entire DevOps lifecycle and achieve the best possible results. This technoogy has been embraced by a wide range of developers and system administrators because of its wide assortment of features and brick blocks of code availability.

Enough of the GitLab, let’s discuss the problem and ways to fix this issue confronting us. See the following guides for more information. For how to use AWS CodeCommit, and how to clone a repository and install software from GitHub on Windows.

Reason for this issue?

There are different interpretations on the internet such as that shared in this link. The error was prompted for me because I was not using the token generated by the project runner.



Turns out I had a wrong token in the config.toml file and this replaced the one generated by the GitLab-register command previously. Entered the right token, boom I was able to unregister the GitLab-runner. At least, this resolved my issue! Below is the syntax of the config.toml file that is currently being edited to resolve this issue.


Generally, when this is done, GitLab-runner should reload automatically. Bt to be safe, just restart manually to ensure it takes effect.

gitlab-runner.exe restart

Now you should be able to unregister GitLab successfully without any further issues.

I hope you found this blog post helpful. If you have any questions, please let me know in the comment session.

Notify of

Inline Feedbacks
View all comments
Would love your thoughts, please comment.x