\n\n# GitLab Runner Helm Chart\n\nGitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab. The GitLab Runner Helm chart automates deployment and configuration of GitLab Runner in Kubernetes clusters using Minimus images.\n\n\n## {{icon-list-search}} Prerequisites\n\n- A subscription to the Minimus images included in the chart\n- A running Kubernetes cluster (v1.21 or higher is recommended)\n- `kubectl` installed and configured\n- Helm v3.8 or higher for OCI support ([Installation instructions](https://helm.sh/docs/intro/install/))\n- Cluster Admin privileges\n- A GitLab instance URL and runner authentication token\n\n

\n\n---\n\n

\n\n## {{icon-rocket}}Try It Out\n\nIn this example we will deploy GitLab Runner on a Kubernetes cluster using the Minimus GitLab Runner Helm chart. GitLab Runner will be configured to execute CI/CD jobs in your Kubernetes cluster.\n\n

\n\n### Step 1: Start Cluster\n\n

\n\nIf you have a cluster to work with, skip this step. Otherwise, start a Minikube cluster. [Deployment instructions](https://minikube.sigs.k8s.io/docs/start/?arch=%2Flinux%2Fx86-64%2Fstable%2Fbinary+download)\n\n

\n\n### Step 2: Create Namespace\n\n

\n\nCreate a namespace:\n\n```\nkubectl create ns gitlab-runner\n```\n\n{{if-enterprise}}\n\nNext, create a Kubernetes secret for the Minimus token:\n\n```\nkubectl create secret docker-registry minimus-registry \\\n --docker-server=reg.mini.dev \\\n --docker-username=minimus \\\n --docker-password={{pull-token}} \\\n --namespace=gitlab-runner\n```\n\n{{/if-enterprise}}\n\n

\n\n### Step 3: Deploy the Helm Chart\n\n

\n\nDeploy the Minimus Helm chart:\n\n```\nhelm install my-gitlab-runner {{oci-url}} \\\n --version {{chart-version}} \\\n --set gitlab-runner.gitlabUrl=https://gitlab.example.com \\\n --set gitlab-runner.runnerToken=YOUR_RUNNER_TOKEN \\\n -n gitlab-runner \\\n --wait\n```\n\nIf you want to override the chart's defaults, go to the Values tab, save a copy locally with your changes. Deploy the chart with your overrides using `-f values.yaml`:\n\n```\nhelm install my-gitlab-runner {{oci-url}} \\\n --version {{chart-version}} \\\n -f values.yaml \\\n --set gitlab-runner.gitlabUrl=https://gitlab.example.com \\\n --set gitlab-runner.runnerToken=YOUR_RUNNER_TOKEN \\\n -n gitlab-runner \\\n --wait\n```\n\n

\n\n### Step 4: Verify GitLab Runner is Running\n\n

\n\nConfirm the chart deployed successfully and GitLab Runner started:\n\n```\nkubectl get pods -n gitlab-runner -l app=gitlab-runner\n```\n\nYou should see output similar to:\n\n```\nNAME READY STATUS RESTARTS AGE\nmy-gitlab-runner-xxxxxxxxx-xxxxx 1/1 Running 0 2m\n```\n\n

\n\n### Step 5: Test Runner Connection\n\n

\n\nCheck the runner logs to verify it has started and is attempting to connect to your GitLab instance:\n\n```\nkubectl logs -n gitlab-runner -l app=gitlab-runner --tail=20\n```\n\nYou should see logs indicating the runner has loaded its configuration and is checking for jobs. Navigate to your GitLab instance under Settings > CI/CD > Runners to verify the runner appears as registered and active.\n\n

\n\n### Step 6: Clean Up\n\n

\n\nUninstall the chart and delete the namespace to remove all resources:\n\n```\nhelm uninstall my-gitlab-runner -n gitlab-runner\nkubectl delete namespace gitlab-runner\n```\n\n

\n\n---\n\n

\n\n## {{icon-info-circle}}Terms & Info\n\n

\n\n### Trademark\n\n

\n\nThis catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.\n\n\n{{if-anonymous}} \n\n

\n\n### Disclaimer\n\n

\n\n\nImages are provided \"as-is\" without warranty of any kind. \"Hardened\" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our [Terms of Use](https://www.minimus.io/terms-of-use).\n\n{{/if-anonymous}}\n\n\n

\n","ociDigest","sha256:5a9a0f603f28d0b67af902baee2c85972d8537e0a06a08f1fff8926265021303","tarballDigest","sha256:7b11c042ba8b1fcb9f290fe4fb8a8dd27d34e7f8ef3b26312cb386f463637c89",[46],"thirdPartyImageName","gitlab/gitlab-runner:latest","2025-11-18T17:24:50.304647Z","2026-08-11T04:46:09.854622Z","private","isCustom","groups",[374],"shortDescription","","published","family","edition","vanilla","fips","thirdPartyVulnsCount",210,"gitlab","webappURL","https://images.minimus.io","docsURL","https://docs.minimus.io/","docsMap",{"_387":388,"_389":390,"_391":366,"_392":393,"_394":395,"_396":397,"_398":399,"_400":401,"_402":366,"_403":366,"_404":366,"_405":406,"_407":408,"_409":410,"_411":412,"_413":414,"_415":366,"_416":417,"_418":366,"_419":366,"_420":366,"_421":366,"_422":366,"_423":366,"_424":366,"_425":366,"_426":366,"_427":366,"_428":429,"_430":431,"_432":433,"_434":435,"_436":437,"_438":439,"_440":366,"_441":366,"_442":366,"_443":366,"_444":445,"_446":366,"_447":448,"_449":450,"_451":452,"_453":452,"_454":455,"_456":366,"_457":366,"_458":459,"_460":461,"_462":463,"_464":465,"_466":467},"user","isAnonymous","isTokensExpired","license","cookiebotCBID","40e95942-a9eb-491e-8406-2f08417ec73b","/","https://docs.minimus.io","/actions","https://docs.minimus.io/remediate/actions","/actions/?","/actions/create","https://docs.minimus.io/remediate/create-action","/advisories","https://docs.minimus.io/remediate/advisories","/advisories/?","https://docs.minimus.io/remediate/cve-advisory","/advisories/?/exploitability","https://docs.minimus.io/remediate/threat-intel#threat-intel","/advisories/?/packages","https://docs.minimus.io/remediate/cve-advisory#status-history","/advisories/?/packages/?","/advisories/?/references","/advisories/?/severity","/charts","https://docs.minimus.io/foundations/helm-charts","/creator/list","https://docs.minimus.io/enterprise-edition/image-creator","/creator/files","https://docs.minimus.io/enterprise-edition/file-bundles","/supply-chain-protection","https://docs.minimus.io/enterprise-edition/supply-chain","/images","https://docs.minimus.io/gallery","/images/?","/images/?/changelog","https://docs.minimus.io/foundations/image-card#changelog","/images/?/changelog/?","/images/?/changelog/?/versions/?/?","/images/?/changelog/?/versions/?/?/exploitability","/images/?/changelog/?/versions/?/?/packages","/images/?/changelog/?/versions/?/?/packages/?","/images/?/changelog/?/versions/?/?/references","/images/?/changelog/?/versions/?/?/severity","/images/?/changelog/?/versions/?/digest-history","/images/?/lines","/images/?/lines/?","/images/?/lines/?/versions/?","https://docs.minimus.io/foundations/image-version","/images/?/lines/?/versions/?/digest-history","https://docs.minimus.io/foundations/image-version#digest-history","/images/?/lines/?/versions/?/sbom","https://docs.minimus.io/foundations/image-version#sbom","/images/?/lines/?/versions/?/specification","https://docs.minimus.io/foundations/image-version#specification","/images/?/lines/?/versions/?/vulnerabilities","https://docs.minimus.io/foundations/image-version#vulnerabilities","/images/?/risk-reduction","https://docs.minimus.io/foundations/image-card#risk-reduction","/images/?/risk-reduction/?","/images/?/risk-reduction/?/exploitability","/images/?/risk-reduction/?/references","/images/?/risk-reduction/?/severity","/images/?/compliance/cis","https://docs.minimus.io/foundations/image-card#compliance","/manage","/manage/self-hosting","https://docs.minimus.io/manage/self-hosted-registry","/manage/subscription","https://docs.minimus.io/introduction/subscription","/manage/logs/activity-log","https://docs.minimus.io/manage/activity-log","/manage/logs/audit-log","/manage/tokens","https://docs.minimus.io/manage/token","/manage/tokens/create","/manage/tokens/delete/?","/manage/access/users","https://docs.minimus.io/manage/users","/manage/access/users/create","https://docs.minimus.io/manage/users#add-users","/manage/access/users/saml","https://docs.minimus.io/sso/saml","/manage/access/groups","https://docs.minimus.io/manage/user-groups","/manage/minicli","https://docs.minimus.io/enterprise-edition/minicli","toast","gtmID","GTM-56RQNQ3D","hubspotID","42541238"]