Installing GitLab using Helm

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

Requirements

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

Tools

helm and kubectl need to be installed on your computer.

Cloud cluster preparation

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

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.