Cloud provider setup for the GitLab chart
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 releases
The GitLab Helm chart supports the following Kubernetes releases:
| Kubernetes release | Status | Minimum GitLab version | Architectures | End of life |
|---|---|---|---|---|
| 1.31 | In development/qualification | x86-64 | 2025-10-28 | |
| 1.30 | Supported | 17.6 | x86-64 | 2025-06-28 |
| 1.29 | Supported | 17.0 | x86-64 | 2025-02-28 |
| 1.28 | Supported | 17.0 | x86-64 | 2024-10-28 |
| 1.27 | Unsupported | 16.6 | x86-64 | 2024-06-28 |
| 1.26 | Unsupported | 16.5 | x86-64 | 2024-02-28 |
| 1.25 | Unsupported | 16.5 | x86-64 | 2023-10-28 |
| 1.24 | Unsupported | 16.5 | x86-64 | 2023-07-28 |
| 1.23 | Unsupported | 16.5 | x86-64 | 2023-02-28 |
| 1.22 | Unsupported | 16.5 | x86-64 | 2022-10-28 |
The GitLab Helm Chart aims to support new minor Kubernetes releases three months after their initial release. We welcome reports made to our issue tracker about compatibility issues in releases newer than those listed above.
Some GitLab features might not work on deprecated releases or releases older than the releases listed above.
For some components, like the agent for Kubernetes and GitLab Operator, GitLab might support different cluster releases.
- For cluster topology recommendations for an environment, see the reference architectures.
- For an example of tuning the resources to fit in a 3 vCPU 12 GB cluster, see the minimal GKE example values file.
Instructions for specific Cloud providers
Create and connect to a Kubernetes cluster in your environment: