gitlab Runner installation


Example

Debian, Ubuntu and CentOS

  1. Add the official repository

Debian/Ubuntu

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash

CentOS

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.rpm.sh | sudo bash
  1. Install the gitlab-ci-multi-runner package

Debian/Ubuntu

sudo apt-get install gitlab-ci-multi-runner

CentOS

sudo yum install gitlab-ci-multi-runner
  1. Register the runner
sudo gitlab-ci-multi-runner register
  • Enter the URL to your GitLab CI. It should look like this http://example.com/ci

  • Enter the registration token. If this is a project specfic runner you can find the token in Project settings -> Runners. If it is a shared runner go to Admin area -> Runners and find the registration token there.

  • Now give your runner a descriptive name.

  • Select the executor which you want to use. Valid executors are: shell (These can be later configured to use sh or bash),docker,docker-ssh,ssh,parallels,virtualbox,docker+machine or docker-ssh+machine. For more detail information on executors check the official documentation.

Windows

  1. Download the runner binary and place it somewhere appropriate on your system.
  2. Open a command prompt as Administrator
  3. Register the runner
<runner-binary> register
  • Enter the URL to your GitLab CI. It should look like this http://example.com/ci

  • Enter the registration token. If this is a project specfic runner you can find the token in Project settings -> Runners. If it is a shared runner go to Admin area -> Runners and find the registration token there.

  • Now give your runner a descriptive name.

  • Select the executor which you want to use. Valid executors are: shell(Can be later configured to use cmd or powershell),ssh,parallels or virtualbox. For more detail information on executors check the official documentation.

  1. (Optional) Register runner as service
<runner-binary> install --user <username> --password <password>
  1. Start the runner
<runner-binary> start