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.11 or higher, compatible with your cluster (+/- 1 minor release from your cluster).
  2. Helm 2.12 or higher. Note Helm 3 is not yet supported.
  3. A Kubernetes cluster, version 1.11 or higher. 6vCPU and 16GB of RAM is recommended.

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