Version Control System

Unregister a GitLab Runner: Easy How To Guide

Unregistering GitLab Runner

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 --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

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 removal
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.

Notify of

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