Installing GitLab on Kubernetes

The easiest method to deploy GitLab on Kubernetes is to take advantage of GitLab's Helm charts. Helm is a package management tool for Kubernetes, allowing apps to be easily managed via their Charts. A Chart is a detailed description of the application including how it should be deployed, upgraded, and configured.

GitLab Chart

This chart contains all the required components to get started, and can scale to large deployments. It offers a number of benefits:

• Horizontal scaling of individual components
• No requirement for shared storage to scale
• Containers do not need root permissions
• Automatic SSL with Let's Encrypt
• An unprivileged GitLab Runner
• and plenty more.

Learn more about the GitLab chart.

GitLab Runner Chart

If you already have a GitLab instance running, inside or outside of Kubernetes, and you'd like to leverage the Runner's Kubernetes capabilities, it can be deployed with the GitLab Runner chart.

Learn more about gitlab-runner chart.

Deprecated Charts

CAUTION: Deprecated: These charts are deprecated. We recommend using the GitLab Chart instead.

GitLab-Omnibus Chart

This chart is based on the GitLab Omnibus Docker images. It deploys and configures nearly all features of GitLab, including:

• a GitLab Runner
• Container Registry
• Mattermost
• automatic SSL
• and an NGINX load balancer.

Learn more about the gitlab-omnibus chart.

Community Contributed Charts

The community has also contributed GitLab CE and EE charts to the Helm Stable Repository. These charts are deprecated in favor of the official Chart.