GitLab Docs
Learn how to use and administer GitLab, the most scalable Git-based fully integrated platform for software development.
Upgrade GitLab
Upgrade GitLab to later versions
Install GitLab Runner
Install GitLab Runner in Kubernetes using the GitLab Helm chart.
Configure GitLab Runner
Advanced configuration options: Use the config.toml configuration file to edit runner settings · Use self-signed certificates: Configure certificates that verify TLS peers when connecting to the GitLab server · Autoscale with Docker Machine: Execute jobs on machines created automatically ...
🌐
GitLab
gitlab.com › gitlab.org › charts › gitlab runner
GitLab.org / charts / GitLab Runner · GitLab
Official Helm Chart for the GitLab Runner (https://gitlab.com/gitlab-org/gitlab-runner)
Discussions

Questions on "GitLab Runner Helm Chart"
rather than [...] creating a Gitlab Runner with a bunch of hand-rolled scripts, using helm makes for a declarative, automated way that we can source control? yeah, it's easier to store the config and a few commands, than to handwrite all Kubernetes yaml configuration. Especially when you have a few different Kubernetes clusters. Is this referenced cluster a separate namespace, e.g. gitlab-runner, that exists solely for purposes of runners? yes, that's why there is --namespace in the helm command. Let's say I was running my prod web services within a namespace of "prod." I am assuming, for purposes of isolation, that I'd be running Gitlab Runners in a separate namespace within the same cluster? exactly More on reddit.com
🌐 r/gitlab
5
4
December 29, 2021
GitLab runner tags
It depends how you're handling runner registration. Tags are initially set at registration time only and they are not part of the runner config file. After registration, tags can only be changed in the UI settings. So, if you use the same auth token of an already-registered runner, redeploying your runner container(s) with new tag parameters will not change the tags. I'm guessing that's your situation. More on reddit.com
🌐 r/gitlab
4
1
October 4, 2024
Best Practices for Deploying Helm Charts in Production with ArgoCD and GitLab
Using branches to segregate environments is a very bad option. I cannot recommend enough this video https://youtu.be/CvMevMHExHk?si=eumCCpgnBixLMn1O More on reddit.com
🌐 r/kubernetes
39
43
September 30, 2024
Helm Deployment Workflow Diagram in GitLab CI/CD
If you push and pull helm charts/images from ECR, you need to make sure that the runner has correct permissions. To do that, you need to create an IRSA role with necessary permissions attached. This is on AWS side. On K8s side you need to attach arn of the role created as an annotation (you’ll find somewhere in docs). In general, CD of Helm Chart is usually 1:1 when compared to image deployment and can be viewed as an extension of image build pipeline. However, the more clusters you have, the less I like it and favor FluxCD, especially in this case as it has insane GitHub/GitLab features. On of the ways to change image version would be to store it after image build/push in GitLab env variable, pass it to helm task, where something similar to helm upgrade —install -n —set image.tag=. Obviously the set flag will differ, depending on structure of your values file. More on reddit.com
🌐 r/kubernetes
11
6
July 21, 2024
🌐
GitLab
docs.gitlab.com › gitlab docs › install › install gitlab runner › helm chart › configure
Configure the GitLab Runner Helm chart | GitLab Docs
To configure the behavior of GitLab Runner build pod in Kubernetes, use a configuration template file. Configuration templates can configure any field on the runner, without sharing specific runner configuration options with the Helm chart.
🌐
GitLab
gitlab.com › gitlab.org › charts › gitlab runner › repository
values.yaml · main · GitLab.org / charts / GitLab Runner · GitLab
August 5, 2026 - Official Helm Chart for the GitLab Runner (https://gitlab.com/gitlab-org/gitlab-runner)
🌐
Datree
datree.io › helm-chart › gitlab-runner-gitlab
Gitlab-runner Helm Chart | Datree
Find out how to install Gitlab-runner helm chart and verify it follows industry best practices.
Find elsewhere
🌐
GitLab
gitlab.com › gitlab.org › charts › gitlab runner › repository
CHANGELOG.md · main · GitLab.org / charts / GitLab Runner · GitLab
June 18, 2026 - Official Helm Chart for the GitLab Runner (https://gitlab.com/gitlab-org/gitlab-runner)
🌐
GitLab
gitlab.com › gitlab.org › charts › gitlab runner › issues
Issues · GitLab.org / charts / GitLab Runner · GitLab
February 24, 2026 - Official Helm Chart for the GitLab Runner (https://gitlab.com/gitlab-org/gitlab-runner)
🌐
Artifact Hub
artifacthub.io › packages › helm › gitlab › gitlab-runner
gitlab-runner 0.91.0 · gitlab/gitlab
This chart deploys a GitLab Runner instance into your Kubernetes cluster. For more information, please review our documentation. Please follow development documentation. gitlab-runner · Repo: JiHu GitLab · Url: h · t · t · p · s · : / ...
🌐
Artifact Hub
artifacthub.io › packages › helm › bitnami › gitlab-runner
gitlab-runner 1.1.8 · bitnami/bitnami
This chart bootstraps a Gitlab Runner deployment on a Kubernetes cluster using the Helm package manager.
🌐
GitLab
gitlab.com › gitlab.org › gitlab-runner › repository
docs/install/kubernetes.md · main · GitLab.org / gitlab-runner · GitLab
To install a specific version of the GitLab Runner Helm chart, add --version <RUNNER_HELM_CHART_VERSION> to your helm install command.
🌐
Reddit
reddit.com › r/gitlab › questions on "gitlab runner helm chart"
r/gitlab on Reddit: Questions on "GitLab Runner Helm Chart"
December 29, 2021 -

Configuring GitLab Runner using the Helm Chart explains how to set up a Gitlab Runner with Helm.

The primary reason for doing this is infrastructure as code? In other words, rather than, I assume, creating a Gitlab Runner with a bunch of hand-rolled scripts, using helm makes for a declarative, automated way that we can source control?

The overall article, https://docs.gitlab.com/runner/install/kubernetes.html notes:

The official way of deploying a GitLab Runner instance into your Kubernetes cluster

Is this referenced cluster a separate namespace, e.g. gitlab-runner, that exists solely for purposes of runners?

Let's say I was running my prod web services within a namespace of "prod." I am assuming, for purposes of isolation, that I'd be running Gitlab Runners in a separate namespace within the same cluster?

🌐
GitLab
docs.gitlab.com › gitlab docs › install › installation methods › helm chart
GitLab Helm chart | GitLab Docs
This chart contains all the required components to get started and can scale to large deployments. For OpenShift-based installations, use GitLab Operator, otherwise you must update the security context constraints yourself. The GitLab Helm chart requires external PostgreSQL, Redis, and object ...
🌐
GitLab
gitlab.com › gitlab.org › charts › gitlab runner › repository
Files · v0.74.1 · GitLab.org / charts / GitLab Runner · GitLab
March 7, 2025 - Official Helm Chart for the GitLab Runner (https://gitlab.com/gitlab-org/gitlab-runner)
🌐
DevOps.dev
blog.devops.dev › running-gitlab-runners-on-kubernetes-8e7fc9bf75ce
Running GitLab Runners on Kubernetes | by Renjith Ravindranathan | DevOps.dev
January 12, 2026 - In this short article, we will explore how we can run Gitlab runners on Kubernetes using GitLab official helm charts with a bit of…
🌐
Collabnix
collabnix.com › install-and-configure-gitlab-runner-on-kubernetes-using-helm
Install and Configure GitLab Runner on Kubernetes using Helm - Collabnix
December 15, 2022 - As with other Helm charts, you can set a values.yaml file to set your own custom config values. You have to modify this file with some necessary details so that the runner is configured to work with your repo. To start, make a copy of the default file which can be found here. There are 2 values that need to be mandatorily set. The first one is gitlabUrl...