Skip to content


Use docker-compose script from the trenchboot-ci repository:

docker-compose up

On first run you will see there is no config file:

gitlab-runner1_1  | ERROR: Failed to load config stat /etc/gitlab-runner/config.toml: no such file or directory  builds=0
gitlab-runner1_1  | ERROR: Failed to load config stat /etc/gitlab-runner/config.toml: no such file or directory  builds=0

You need to perform the registration.


  1. Go to CI/CD settings in your group.

  2. Go to the Set up a group Runner manually section and set the registration token as environmental variable:

bash export REGISTRATION_TOKEN="QZgfyepK2_t3SshRgX2K"

  1. Register using the script:

```bash ./

Runtime platform arch=amd64 os=linux pid=142 revision=ce065b93 version=12.10.1 Running in system-mode.

Registering runner... succeeded runner=QZgfyepK Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded! ```

  1. The containter logs should become:

gitlab-runner1_1 | Configuration loaded builds=0

  1. The runner should be available in the CI/CD group settings


  1. Refer to the register documentation if needed.


Local runner can run the exact same jobs as a shared runnners in the cloud. Typically, we will want to mark some specific jobs to run on the local runner instead. Examples of such jobs: - local infastructure acces required, - extensive hardware requirementes (shared runners have limited resources).

In the we are providing a list of tags as one of the arguments:

--tag-list local \

In this case, we mark our runner with a local tag. We can mark a specific job (in a .gitlab-ci.yml file) with the same tag, to make sure it will always run on a local runner, rather the shared (cloud one). The syntax is:

    - local

Please refer to the tags description in the official documentation.

Last update: November 30, 2021