Cloud provider setup for the GitLab chart All tiers Self-managed

Before you deploy the GitLab chart, you must configure resources for the cloud provider you choose.

The GitLab chart is intended to fit in a cluster with at least 8 vCPU and 30 GB of RAM. If you are trying to deploy a non-production instance, you can reduce the defaults to fit into a smaller cluster.

Supported Kubernetes versions

The GitLab Helm chart supports the following Kubernetes versions:

  • A cluster running Kubernetes 1.20 or newer is required for all components to work.
  • 1.26 support is fully tested as of Chart 7.5 (GitLab 16.5).
  • 1.27 and 1.28 are expected to also be compatible with Chart 7.6 (GitLab 16.6), and full testing is in progress.

The GitLab Helm Chart aims to support new minor Kubernetes versions three months after their initial release. We welcome any compatibility issues with releases newer than those listed above in our issue tracker.

Some GitLab features might not work on versions older than the versions listed above.

For some components, like the agent for Kubernetes and GitLab Operator, GitLab might support different cluster versions.

caution
Kubernetes nodes must use the x86-64 architecture. Support for multiple architectures, including AArch64/ARM64, is under active development. See issue 2899 for more information.

Instructions for specific Cloud providers

Create and connect to a Kubernetes cluster in your environment: