GitLab Documentation

Install GitLab Runner using the official GitLab repositories

Currently we support:

If you want to use the Docker executor, install it before using the Runner:

curl -sSL https://get.docker.com/ | sh

Installing the Runner

To install the Runner:

  1. Add GitLab's official repository:

    # For Debian/Ubuntu
    curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash
    
    # For RHEL/CentOS
    curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.rpm.sh | sudo bash
    

    Note: Debian users should use APT pinning

    Since Debian Stretch, Debian maintainers added their native package with the same name as is used by our package, and by default the official repositories will have a higher priority.

    If you want to use our package you should manually set the source of the package. The best would be to add the pinning configuration file. Thanks to this every next update of the Runner's package - whether it will be done manually or automatically - will be done using the same source:

    cat > /etc/apt/preferences.d/pin-gitlab-runner.pref <<EOF
    Explanation: Prefer GitLab provided packages over the Debian native ones
    Package: gitlab-ci-multi-runner
    Pin: origin packages.gitlab.com
    Pin-Priority: 1001
    EOF
    
  2. Install gitlab-ci-multi-runner:

    # For Debian/Ubuntu
    sudo apt-get install gitlab-ci-multi-runner
    
    # For RHEL/CentOS
    sudo yum install gitlab-ci-multi-runner
    
  3. Register the Runner

After completing the step above, the Runner should be started already being ready to be used by your projects!

Make sure that you read the FAQ section which describes some of the most common problems with GitLab Runner.

Updating the Runner

Simply execute to install latest version:

# For Debian/Ubuntu
sudo apt-get update
sudo apt-get install gitlab-ci-multi-runner

# For RHEL/CentOS
sudo yum update
sudo yum install gitlab-ci-multi-runner

Manually download packages

You can manually download the packages from the following URL: https://packages.gitlab.com/runner/gitlab-ci-multi-runner