Cloud provider setup for the GitLab chart
- Tier: Free, Premium, Ultimate
- Offering: GitLab 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 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 | Deprecated | 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.
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.
- 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:
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support