Installing GitLab using Helm

Note: There are currently known limitations when using this chart, and not all features of GitLab are available.

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


In order to deploy GitLab on Kubernetes, the following are required:

  1. kubectl 1.13 or higher, compatible with your cluster (+/- 1 minor release from your cluster).
  2. Helm v2 (2.12 or higher, excluding 2.15) or v3 (3.0.2 or higher).
  3. A Kubernetes cluster, version 1.13 or higher. 8vCPU and 30GB of RAM is recommended.
Note: Helm is released as v2 and v3 versions. While Helm v2 is still in use, it is recommended that Helm v3 be moved to future proof updates and support a better security model. If GitLab has been previously installed with Helm v2 and it is desired to use Helm v3, then 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

Note: Kubernetes 1.13 or higher 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.

Migrating from Omnibus GitLab to Kubernetes

To migrate your existing Omnibus GitLab instance to your Kubernetes cluster, follow the migration documentation.