Install self-managed GitLab

Try GitLab today. Download, install and maintain your own GitLab instance.

Trial – start your Free Ultimate Trial today

Self-managed – install on your own infrastructure

SaaS – get started with our SaaS offering

Marketplace – purchase seamlessly using the cloud marketplace of your choice

Recommended installation method

Official Linux package

This is the recommended method for getting started. The Linux packages are mature, scalable, and are used today on GitLab.com. If you need additional flexibility and resilience, we recommend deploying GitLab as described in the reference architecture documentation.

Linux installation is quicker to install, easier to upgrade and contains features to enhance reliability not found in other methods. Install via a single package (also known as Omnibus) that bundles all the different services and tools required to run GitLab. At least 4 GiB of RAM is recommended (minimum requirements).

Please refer to our Packages repository (GitLab-ee or GitLab-ce) to ensure that the required GitLab version is available for the host OS version.

Kubernetes Deployments

When installing GitLab on Kubernetes, there are some trade-offs that you need to be aware of:

  • 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, as most services are deployed in a redundant fashion.
  • There are some feature limitations to be aware of.

Use this method if your infrastructure is built on Kubernetes and you’re familiar with how it works. The methods for management, observability, and some concepts are different than traditional deployments. The helm chart method is for Vanilla Kubernetes deployments and the GitLab Operator can be used to deploy GitLab on an OpenShift cluster. The GitLab Operator can be used to automate Day 2 operations in both OpenShift and vanilla Kubernetes deployments.