Installation methods

You can install GitLab by using any of the following methods.

Installation method Description When to choose
Linux package The official deb/rpm packages (also known as Omnibus GitLab). The package has GitLab and dependent components, including PostgreSQL, Redis, and Sidekiq. Use if you want the most mature, scalable method. This version is also used on GitLab.com.
- For additional flexibility and resilience, see the reference architecture documentation.
- Review the system requirements.
- View the list of supported Linux operating systems.
Helm chart A chart for installing a cloud-native version of GitLab and its components on Kubernetes. Use if your infrastructure is on Kubernetes and you're familiar with how it works. Management, observability, and some concepts are different than traditional deployments.
- Administration and troubleshooting requires Kubernetes knowledge.
- It can be more expensive for smaller installations. The default installation requires more resources than a single node Linux package deployment, because most services are deployed in a redundant fashion.

Docker The GitLab packages in a Docker container. Use if you're familiar with Docker.
Source GitLab and its components from scratch. Use if none of the previous methods are available for your platform. Can use for unsupported systems like *BSD.
GitLab Environment Toolkit (GET) A set of automation tools. Use to deploy a reference architecture on most major cloud providers. Has some limitations and manual setup for production environments.
GitLab Operator An installation and management method that follows the Kubernetes Operator pattern. Use to run GitLab in an OpenShift environment.

Cloud providers

You can install GitLab on several cloud providers.

Cloud provider Description
AWS (HA) Install GitLab on AWS using the community AMIs provided by GitLab.
Google Cloud Platform (GCP) Install GitLab on a VM in GCP.
Azure Install GitLab from Azure Marketplace.

Unsupported Linux distributions and Unix-like operating systems

  • Arch Linux
  • Fedora
  • FreeBSD
  • Gentoo
  • macOS

Installation of GitLab on these operating systems is possible, but not supported. See the installation from source guide and the installation guides for more information.

See OS versions that are no longer supported for Omnibus installs page for a list of supported and unsupported OS versions as well as the last support GitLab version for that OS.

Microsoft Windows

GitLab is developed for Linux-based operating systems. It does not run on Microsoft Windows, and we have no plans to support it in the near future. For the latest development status, view this issue. Consider using a virtual machine to run GitLab.