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.

Before you install, review the system requirements and supported platforms.

Operating systems

Linux
Install GitLab Runner from a GitLab repository using your package manager.
Linux manual install
Manually download and install the GitLab Runner binary on Linux.
FreeBSD
Install GitLab Runner on FreeBSD systems.
macOS
Download, install, and configure GitLab Runner as a user-mode service on Apple Silicon and Intel x86-64 systems.
Windows
Install GitLab Runner on Windows systems.
z/OS
Install GitLab Runner manually on z/OS.

Containers

Docker
Run GitLab Runner in a Docker container.
Helm chart
Install GitLab Runner in Kubernetes using the GitLab Helm chart.
GitLab agent
Install GitLab Runner using the GitLab agent for Kubernetes.
Operator
Install GitLab Runner using the GitLab Operator for Kubernetes.

Other installation options

Bleeding edge releases
Install the latest development builds of GitLab Runner.