The config.toml file is what configures a runner. You wouldn't have one unless you're running your own gitlab-runners, in which case it would be in /etc/gitlab-runner/config.toml on the host running the runner. More information on Gitlab Runner and running it yourself is available here.

Answer from Adam Marshall on Stack Overflow
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · main · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitLab
docs.gitlab.com › gitlab docs › install › configure gitlab runner › advanced configuration
Advanced configuration | GitLab Docs
Configure this section once for all runners, not for each individual runner. # Example `config.toml` file with session server configured concurrent = 100 # A global setting for job concurrency that applies to all runner sections defined in this `config.toml` file log_level = "warning" log_format = "runner" check_interval = 3 # Value in seconds [session_server] listen_address = "[::]:8093" # Listen on all available interfaces on port `8093` advertise_address = "runner-host-name.tld:8093" session_timeout = 1800
Discussions
Gitlab: where is config.toml? - Stack Overflow
The config.toml file is what configures a runner. You wouldn't have one unless you're running your own gitlab-runners, in which case it would be in /etc/gitlab-runner/config.toml on the host running the runner. More on stackoverflow.com
🌐 stackoverflow.com
GitLab Runners - Using CICD variables in toml
Variables in the project will already be used in the environment, so in before_script, script, after_script job part. The toml file cannot read environment created during CI/CD, because it's a configuration " before" any ci/CD even start. But...why the double configuration? More on reddit.com
🌐 r/gitlab
5
2
December 12, 2023
How to use local image from docker-compose on gitlab ci
Id recommend going to r/gitlab those guys know the backend of a gitlab environment far better than we do collectively. More on reddit.com
🌐 r/devops
4
6
July 4, 2018
Gitlab runner config.toml values vs. environment vars
No, those variables are used at registration to set the values within the TOML.  For an already-registered runner, config.toml is the gospel. More on reddit.com
🌐 r/gitlab
3
2
June 12, 2025
Videos
🌐 m.youtube.com
How to configure your own Gitlab CI Runner
23:05
🌐 YouTube
Gitlab Runner - Create a private runner on Ubuntu 22.04 - YouTube
March 27, 2023
3.34K
🌐 youtube.com
Install and Configure GitLab Runner on Kubernetes with Helm
28:24
🌐 YouTube
Configure GitLab CI Runner with Docker executor using AWS EC2 - ...
April 21, 2022
08:08
🌐 YouTube
Learn about GitLab runner management - YouTube
October 29, 2019
1.55K
View all
View all
🌐
DevOpsSchool.com
devopsschool.com › blog › gitlab-tutorials-understanding-about-config-toml-example-of-config-toml
GitLab Tutorials: Understanding runner config.toml & Example of config.toml
The config.toml file is what configures a runner. You wouldn’t have one unless you’re running your own gitlab-runners, in which case it would be in /etc/gitlab/config.toml on the host running the runner.
🌐
GitHub
github.com › veertuinc › gitlab-runner › blob › master › config.toml.example
gitlab-runner/config.toml.example at master · veertuinc/gitlab-runner
May 29, 2024 - Contribute to veertuinc/gitlab-runner development by creating an account on GitHub.
Author: veertuinc
🌐
GitLab
docs.gitlab.com › gitlab docs › install › configure gitlab runner
Configure GitLab Runner | GitLab Docs
Learn how to configure GitLab Runner. Advanced configuration options: Use the config.toml configuration file to edit runner settings.
🌐
Stack Overflow
stackoverflow.com › questions › 68830713 › gitlab-where-is-config-toml
Gitlab: where is config.toml? - Stack Overflow
Top answer
1 of 3
29

The config.toml file is what configures a runner. You wouldn't have one unless you're running your own gitlab-runners, in which case it would be in /etc/gitlab-runner/config.toml on the host running the runner. More information on Gitlab Runner and running it yourself is available here.

2 of 3
6

The locations where it could be is documented here.

You can find the config.toml file in:

  • /etc/gitlab-runner/ on *nix systems when GitLab Runner is executed as root (this is also the path for service configuration)
  • ~/.gitlab-runner/ on *nix systems when GitLab Runner is executed as non-root
  • ./ on other systems

But if your Run GitLab Runner in a Docker container, your config is located at

  • /etc/gitlab-runner

inside the GitLab Runner Docker container filesystem. This will correspond to the location

  • /srv/gitlab-runner/config

of your host file system if the container was started as described in the docs

docker run -d --name gitlab-runner --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitlab/gitlab-runner:latest
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · v18.5.0 · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
Find elsewhere
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · 2ac5fc125092020517da9671a6a75a7ca134f6d7 · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · v12.10.1 · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitLab
gitlab.com › gitlab.org › cloud native › distroless › gitlab-runner › repository
config.toml.example · v1.9.1 · GitLab.org / Cloud Native / distroless / gitlab-runner · GitLab
concurrent = 4 [[runners]] name = "ruby-2.1" url = "https://CI/" token = "TOKEN" limit = 2 executor = "shell" builds_dir = "" shell = "bash" [[runners]] name = "ruby-2.1-docker" url = "https://CI/" token = "TOKEN" limit = 0 executor = "docker" builds_dir = "" [runners.docker] host = "" image = "ruby:2.1" privileged = false disable_cache = false cache_dir = "" [[runners]] name = "ruby-2.1-docker-ssh" url = "https://CI/" token = "TOKEN" limit = 0 executor = "docker-ssh" builds_dir = "" [runners.docker] host = "" image = "ubuntu-upstart:14.04" privileged = false disable_cache = false cache_dir = "" [runners.ssh] port = "22" user = "root" password = "docker.io" [[runners]] name = "production-server" url = "https://CI/" token = "TOKEN" limit = 0 executor = "ssh" builds_dir = "" [runners.ssh] host = "my-production-server" port = "22" user = "root" password = "production-server-password"
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · 5e6f0580fc000751b3ab35cbb67995188cb177fa · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitHub
github.com › gitlabhq › gitlab-runner › blob › master › config.toml.example
gitlab-runner/config.toml.example at master · gitlabhq/gitlab-runner
Mirror | Please open new issues in our issue tracker on GitLab.com - gitlab-runner/config.toml.example at master · gitlabhq/gitlab-runner
Author: gitlabhq
🌐
GitLab
docs.gitlab.com › gitlab docs › install › configure gitlab runner › commands
GitLab Runner commands | GitLab Docs
Read from a configuration file to use a specific runner’s configuration. For example, a single job with a configuration file: gitlab-runner run-single -c ~/.gitlab-runner/config.toml -r runner-name
🌐
Interesting IT Tip's
interestingittips.wordpress.com › tag › config-toml
config.toml – Interesting IT Tip's
$ sudo gitlab-runner list # Answer Runtime platform arch=arm os=linux pid=19991 revision=8fa89735 version=13.6.0 Listing configured runners ConfigFile=/etc/gitlab-runner/config.toml # To verify delete $ sudo gitlab-runner verify --delete $ sudo service gitlab-runner restart # To uninstall the runner executable # sudo apt remove gitlab-runner
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · 1-10-stable · GitLab.org / gitlab-runner · GitLab
GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitHub
github.com › gitlabhq › gitlab-runner › blob › main › config.toml.example
gitlab-runner/config.toml.example at main · gitlabhq/gitlab-runner
Mirror | Please open new issues in our issue tracker on GitLab.com - gitlab-runner/config.toml.example at main · gitlabhq/gitlab-runner
Author: gitlabhq
🌐
Gitlab
docs.gitlab.co.jp › runner › configuration › advanced-configuration.html
Advanced configuration | GitLab
This example uses /path/to/bind/from/host of the CI/CD host in the container at /path/to/bind/in/container. GitLab Runner 11.11 and later mount the host directory for the defined services as well. To use private registries as a source of images for your jobs, you can set the authorization ...
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
config.toml.example · fca4d04b07e39d287f14f58913a40373e229d0ef · GitLab.org / gitlab-runner · GitLab
October 1, 2018 - GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab
🌐
GitLab
docs.gitlab.com › gitlab docs › administer › administer gitlab runner › register a runner
Registering runners | GitLab Docs
If you used a configuration volume ... use the URL for your GitLab instance. For example, if your project is hosted on gitlab.example.com/yourname/yourproject, your GitLab instance URL is https://gitlab.example.com....
🌐
GitLab
docs.gitlab.com › runner › examples › gitlab.html
How to configure GitLab Runner for GitLab CE integration tests
These cookies enable helpful but non-essential website functions that improve your website experience. By recognizing you when you return to our website, they may, for example, allow us to personalize our content for you or remember your preferences. If you do not allow these cookies then some or all of these services may not function properly.