Skip to main content Go to GitLab Docs homepage
What's new?
What's new? Get free trial
  • Use GitLab
  • GitLab Duo
  • Extend
  • Install
  • Administer
  • Subscribe
  • Contribute
  • Solutions
The GitLab Docs website is now available in Japanese!

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
Install GitLab Runner on macOS.
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.
GitLab Docs logo
  • Facebook
  • LinkedIn
  • Twitter
  • YouTube
Creative Commons License
Company
  • About GitLab
  • View pricing
  • Try GitLab for free
Feedback
  • View page source
  • Edit in Web IDE
  • Contribute to GitLab
  • Suggest updates
Help & Community
  • Get certified
  • Get support
  • Post on the GitLab forum
Resources
  • Terms
  • Privacy statement
  • Use of generative AI
  • Acceptable use of user licenses