Install GitLab Runner

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed

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:

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

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.