Install GitLab Runner
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
GitLab Runner runs the CI/CD jobs defined in GitLab. GitLab Runner can run as a single binary and has no language-specific requirements.
For security and performance reasons, install GitLab Runner on a machine separate from the machine that hosts your GitLab instance.
Supported operating systems
You can install GitLab Runner on:
- Linux from a GitLab repository or manually
- FreeBSD
- macOS
- Windows
Bleeding-edge binaries are also available.
To use a different operating system, ensure the operating system can compile a Go binary.
Supported containers
You can install GitLab Runner with:
Supported architectures
GitLab Runner is available for the following architectures:
- x86
- AMD64
- ARM64
- ARM
- s390x
- ppc64le
- riscv64
System requirements
The system requirements for GitLab Runner depend on the:
- Anticipated CPU load of CI/CD jobs
- Anticipated memory usage of CI/CD jobs
- Number of concurrent CI/CD jobs
- Number of projects in active development
- Number of developers expected to work in parallel
For more information about the machine types available for GitLab.com, see GitLab-hosted runners.
FIPS-compliant GitLab Runner
A GitLab Runner binary compliant with FIPS 140-2 is available for Red Hat Enterprise Linux (RHEL) distributions and the AMD64 architecture. Support for other distributions and architectures is proposed in issue 28814.
This binary is built with the Red Hat Go compiler and calls into a FIPS 140-2 validated cryptographic library. A UBI-8 minimal image is used as the base for creating the GitLab Runner FIPS image.
For more information about using FIPS-compliant GitLab Runner in RHEL, see Switching RHEL to FIPS mode.
Docs
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.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
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).
Request support