Installing GitLab using Helm

Install GitLab on Kubernetes with the cloud native GitLab Helm chart.


To deploy GitLab on Kubernetes, the following are required:

  1. kubectl 1.16 or higher, compatible with your cluster (+/- 1 minor release from your cluster).
  2. Helm v3 (3.3.1 or higher).
  3. A Kubernetes cluster, version 1.16 through 1.21. 8vCPU and 30GB of RAM is recommended.

If using the in-chart NGINX Ingress Controller (nginx-ingress.enabled=true), then Kubernetes 1.19 or newer is required.
Support for Kubernetes 1.22 is under active development - see &6883 for more information.
Helm v2 has reached end of lifecyle. If GitLab has been previously installed with Helm v2, you should use Helm v3 as soon as possible. Please consult the Helm migration document.

Environment setup

Before proceeding to deploying GitLab, you need to prepare your environment.


helm and kubectl need to be installed on your computer.

Cloud cluster preparation

Kubernetes 1.16 through 1.21 is required, due to the usage of certain Kubernetes features.

Follow the instructions to create and connect to the Kubernetes cluster of your choice:

Deploying GitLab

With the environment set up and configuration generated, you can now proceed to the deployment of GitLab.

Upgrading GitLab

If you are upgrading an existing Kubernetes installation, follow the upgrade documentation instead.

Migrate from or to the GitLab Helm chart

To migrate your existing GitLab Linux package installation to your Kubernetes cluster, or vice versa, follow the migration documentation.