Configure GitLab Runner

Learn how to configure GitLab Runner.

Advanced configuration options: Use the config.toml configuration file to edit runner settings.
Use self-signed certificates: Configure certificates that verify TLS peers when connecting to the GitLab server.
Autoscale with Docker Machine: Execute jobs on machines created automatically by Docker Machine.
Autoscale GitLab Runner on AWS EC2: Execute jobs on auto-scaled AWS EC2 instances.
Autoscale GitLab CI on AWS Fargate: Use the AWS Fargate driver with the GitLab custom executor to run jobs in AWS ECS.
Graphical Processing Units: Use GPUs to execute jobs.
The init system: GitLab Runner installs its init service files based on your operating system.
Supported shells: Execute builds on different systems by using shell script generators.
Security considerations: Be aware of potential security implications when running your jobs with GitLab Runner.
Runner monitoring: Monitor the behavior of your runners.
Clean up Docker cache automatically: If you are running low on disk space, use a cron job to clean old containers and volumes.
Configure GitLab Runner to run behind a proxy: Set up a Linux proxy and configure GitLab Runner. This setup works well with the Docker executor.
Handling rate limited requests.
Configure GitLab Runner Operator.

Edit this page to fix an error or add an improvement in a merge request.

Create an issue to suggest an improvement to this page.

Create an issue if there's something you don't like about this feature.

Propose functionality by submitting a feature request.

View pricing to see all GitLab tiers and features, or to upgrade.

Try GitLab for free with access to all features for 30 days.

If you didn't find what you were looking for, search the docs.

If you want help with something specific and could use community support, post on the GitLab forum.

For problems setting up or using this feature (depending on your GitLab subscription).

Help & feedback