Install GitLab Runner | GitLab Docs
- 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.