Installing GitLab using Helm

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 v3 (3.2.0 or higher).
  3. A Kubernetes cluster, version 1.13 or higher. 8vCPU and 30GB of RAM is recommended.
noteHelm 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

noteKubernetes 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.