
Unregister a GitLab Runner: Your go-to tool for executing CI/CD tasks and reporting outcomes to GitLab. Install this versatile open-source project on your infrastructure. Enhance security and performance by utilizing a separate machine from your GitLab instance.
Here are some related guides: How to install Git on macOS, How to uninstall Git on macOS, Practical Git use with markdown, how to clone a repository and install software from GitHub on Windows, how to use AWS CodeCommit, Azure DevOps and GitHub integration for Docker and Kubernetes deployment, and how to build your first CI/CD Pipeline in Azure DevOps using ASP.Net Core Application.
This operation cannot be undone. It updates the configuration file, so make sure to have a backup of config.toml before executing (un-registering) it.
Use the GitLab-runner CLI to unregister the runner
You can only add a single instance of GitLab runner to a system. This registered runner is added to the configuration file. Unregister a GitLab Runner and discover the intriguing aspect of the ability to employ multiple configurations within a singular GitLab Runner installation. Executing gitlab-runner register
adds a new configuration entry. It doesn’t remove the previous ones.
By URL and token: To unregister a specific runner, first, get the runner’s details by executing the following command below.
gitlab-runner list
If you have access to the device which was used to register the GitLab runner, you can unregister the runner using the following command, where you replace the {TOKEN}
with the token of your GitLab runner (e.g. 250cff67
in the example above)
gitlab-runner unregister --url https://gitlab.org/ --token {TOKEN}
Note that when multiple runners share a name, the removal process affects only the first runner.
gitlab-runner unregister --name test-runner
All runners: You can also unregister all runners by using the command below.
gitlab-runner unregister --all-runners
Service-related commands
The following commands allow you to manage the runner as a system or user service. Use them to install, uninstall, start, and stop the runner service. Kindly refer to these related guides on how to uninstall GitLab from your Windows device, and how to install, register and start GitLab Runner on Windows.

gitlab-runner install gitlab-runner uninstall gitlab-runner start gitlab-runner stop gitlab-runner restart gitlab-runner status

If you’re looking for assistance, our guide on how to Unregister a GitLab Runner can be of great help. Feel free to leave any questions in the comments below.