Where Is the GitLab Runner Config File?
GitLab Runner config.toml location on Linux with executor and cache settings.
Last updated
GitLab Runner registers executors, concurrency and cache in config.toml, with the exact path depending on install method and service user. Tokens live inside, so the file deserves restricted permissions.
Re-registering recreates the file from scratch, which drops custom executors. Edit the live file and restart the runner instead.
Where GitLab Runner stores this, by platform
/etc/gitlab-runner/config.toml
Main config for service installs with runners, executors and cache sections. User-mode installs keep it at ~/.gitlab-runner/config.toml instead. Confirm which path your service loads before editing. Restart the runner after changes and restrict the file to root.
Frequently asked questions
How do I find my runner config?
Check the service definition for --config, defaulting to the paths above. gitlab-runner verify also prints the file it reads.
Where are GitLab Runner registration tokens?
Inside config.toml above per runner stanza. Rotate them in GitLab if the file ever leaks.
Notice an outdated path? Let us know.