Configuring the Runner

5.8. Configure the Runner

Once the runner is registered, the basic configuration is already set. However, if you need to customize settings or add advanced configurations, you can edit the config.toml file. Usually, the config.toml file is located in:

Linux: /etc/gitlab-runner/config.toml
macOS: /usr/local/etc/gitlab-runner/config.toml
Windows: C:\GitLab-Runner\config.toml

Example configuration for a Docker executor:

[[runners]]
  name = "My Docker Runner"
  url = "https://gitlab.com/"
  token = "YOUR_REGISTRATION_TOKEN"
  executor = "docker"
  [runners.custom_build_dir]
  [runners.docker]
    tls_verify = false
    image = "alpine:latest"
    privileged = true
    disable_entrypoint_overwrite = false
    oom_kill_disable = false
    disable_cache = false
    volumes = ["/cache"]
    shm_size = 0
  [runners.cache]
    [runners.cache.s3]
    [runners.cache.gcs]

Note: The config.toml file allows you to customize settings such as the Docker image, privilege mode, volumes, and more.

Specific Runners

Configuring the Runner

5.8. Configure the Runner