How to Install GitLab Runner on Ubuntu such as 22.04 or 20.04

GitLab Runner is a tool developed to allow users to run continuous integration and continuous deployment (CI/CD) jobs for GitLab projects. It works as an agent that executes the commands specified in GitLab CI/CD configuration. We can easily install GitLab Runner on your Ubuntu Linux to automate the testing and deployment process, which ultimately makes it easy for us to manage and maintain software projects.

We will go through the steps for installing GitLab Runner on Ubuntu. 


To follow this tutorial you must have sudo (administrative) privileges and ofcourse an Ubuntu server or desktop with an internet connection. Apart from this, a GitLab account is also required to register and use GitLab Runner.

Step 1: Update Ubuntu Packages

As usual before installing any package on Linux start with a system update command to not only update the package list but also upgrade the existing packages to their latest versions. So, in your command terminal run:

sudo apt update && sudo apt upgrade

Step 2: Add the GitLab Runner repository

The Runner is not like some common Linux packages that are available through the default Ubuntu system repository. Therefore, to install it easily, let’s add the official repository of GitLab Runner. The process of adding its repo is quite straightforward because of the script provided by its developers. Here are the commands to follow:

2.1. Install Dependencies

We need curl, if you don’t have it already use this command to get it.

sudo apt install -y curl

2.2.  Add the Repository:

Use the given command to run the script that will configure the required repo on our Ubuntu Linux system.

curl -L | sudo bash
Add the GitLab Runner repository

Step 3. Install GitLab Runner on Ubuntu 20.04 or 22.04

Now, we have the source configured on our Ubuntu system from where we can download and install the latest version of GitLab Runner on our Linux system. Now, let’s use the APT package manager to install it.

sudo apt install gitlab-runner
Install GitLab Runner on Ubuntu

Step 4: Register GitLab Runner

With GitLab Runner installed, you need to register it with your GitLab account. This registration associates the Runner with your projects and allows it to execute CI/CD jobs. Follow the steps below to register the Runner:

3.1. Obtain your GitLab Registration Token

Go to your GitLab project on the GitLab website and sign in with your account.

After that, if you already have a project then open that otherwise create a new one. Now, click on your project to open it.

Open your GitLab Runner Project

From the Project Dashboard where you can see all the files of it, you will also have multiple options on the left side there click on Settings to select CI/CD.

Open CI CD of Project

There, look for the section titled “Runners” and open your project’s runner to copy the –token value given there which is also your registration token.

Note: If you don’t have any Runners then click on the New Project Runner to create one.

Runners Registration token

3.2. Register the GitLab Runner

Once you have copied the token from your Runner page, get back to the Ubuntu terminal where you have just installed the GitLab Runner and run the given command:

sudo gitlab-runner register

The registration process will prompt you for the following information:

  1. GitLab instance URL: Enter the URL of your GitLab instance, typically “” for GitLab SaaS.
  2. Registration token: Paste the registration token you obtained in Step 3.1.
  3. Runner description: Provide a descriptive name for your Runner (e.g., “My Ubuntu Runner”). You can give whatever you want.
  4. Runner tags, if asked (optional): You can add tags to your Runner to control which jobs it picks up.
  5. Executor: Choose an executor based on your project needs. The “shell” executor is sufficient for most use cases.
  6. After the registration is successful, the Runner is ready to execute jobs for your projects.
Register Runner Command

Step 5: Start and Enable its Service

Once you have successfully registered the GitLab Runner, now it’s time to start and enable its service, so that it can automatically get started every time with the system boot.

Start the service

sudo gitlab-runner start

Enable the service to start with the system boot

sudo gitlab-runner enable

Step 6: Verify Runner Status

To confirm that GitLab Runner is active and registered with your GitLab account, use the following command:

sudo gitlab-runner verify

This command should return a “is valid” message that will indicate our Runner is online and can accept jobs, as shown in the below-given screenshot:

Verify GitLab Runner Status

Uninstallation (optional)

If you don’t require the Gitlab runner anymore on your Ubuntu system then to remove it completely, here are the commands to follow:

  • First, stop Runner service:
sudo gitlab-runner stop
  • Now, remove it from your system:
sudo apt autoremove --purge gitlab-runner
  • After that also delete the repository:
sudo rm -rf /etc/apt/sources.list.d/runner_gitlab-runner.list
  • Finally, remove the user and directories created by Runner:
sudo deluser --remove-home gitlab-runner
sudo rm -rf /etc/gitlab-runner


So, these were the steps that we can use to not only install GitLab Runner successfully on our Ubuntu system and register it with a GitLab account but even to remove it completely if required later.

It can help you greatly to utilize GitLab CI/CD pipelines to automate the testing and deployment processes for your projects.

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.