\n\n# GitHub Actions Runner Scale Set Helm Chart\n\nA Helm chart for deploying an AutoScalingRunnerSet that enables autoscaling of self-hosted GitHub Actions runners on Kubernetes. The GitHub Actions Runner Scale Set Helm chart automates deployment and configuration of GitHub Actions runner scale sets 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- The **GitHub Actions Runner Scale Set Controller** (`gha-runner-scale-set-controller`) chart must be installed in the cluster before deploying runner scale sets\n\n**Note**: This chart creates `AutoscalingRunnerSet` Custom Resources that are managed by the ARC controller. The controller chart must be installed first to register the required CRDs and start the controller.\n\n

\n\n---\n\n

\n\n## {{icon-rocket}}Try It Out\n\nIn this example we will deploy a GitHub Actions runner scale set on a Kubernetes cluster using the Minimus GitHub Actions Runner Scale Set Helm chart. The scale set will register self-hosted runners that autoscale based on workflow demand.\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 Secret\n\n

\n\nFirst, create a namespace:\n\n```\nkubectl create ns gha-runner-scale-set\n```\n\nNext, create a Kubernetes secret for the Minimus token so Helm will be able to pull images from the Minimus registry:\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=gha-runner-scale-set\n```\n\n

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

\n\nFirst, ensure the ARC controller is installed. Then deploy the runner scale set:\n\n```\nhelm install my-gha-runner-scale-set {{oci-url}} \\\n -n gha-runner-scale-set \\\n --set githubConfigUrl=\"https://github.com/YOUR_ORG\" \\\n --set githubConfigSecret.github_token=\"ghp_YOUR_TOKEN\" \\\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-gha-runner-scale-set {{oci-url}} \\\n -f values.yaml \\\n -n gha-runner-scale-set \\\n --wait\n```\n\n

\n\n### Step 4: Verify GitHub Actions Runner Scale Set is Running\n\n

\n\nConfirm the AutoscalingRunnerSet was created:\n\n```\nkubectl get autoscalingrunnersets.actions.github.com -n gha-runner-scale-set\n```\n\nYou should see output similar to:\n\n```\nNAME ENTERPRISE ORGANIZATION REPOSITORY GROUP MIN MAX DESIRED RUNNING FINISHED STATUS AGE\nmy-gha-runner-scale-set 2m\n```\n\n

\n\n### Step 5: Verify Runner Registration\n\n

\n\nCheck that the runner scale set has registered with GitHub:\n\n```\nkubectl get autoscalingrunnersets.actions.github.com my-gha-runner-scale-set -n gha-runner-scale-set -o yaml\n```\n\nVerify the `spec.githubConfigUrl` matches your organization or repository URL. When workflows trigger, the controller will automatically scale runner pods up and down.\n\n

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

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

\n","ociDigest","sha256:ad349a284ca02b73b1899862ad39f7effe3465a9e497d4b539e72eab028bb4d4","tarballDigest","sha256:5d294fb4992eea9ab6f6d0a3c29a5548de223fe7a48a8e6bb6ab4cadc1b5a56e","dev",236227,[162],"thirdPartyImageName","ghcr.io/actions/actions-runner","2026-04-20T01:47:54.067217Z","2026-10-27T01:50:59.232399Z","private","isCustom","groups",[137],"shortDescription","published","family","edition","vanilla","fips","webappURL","https://images.minimus.io","docsURL","https://docs.minimus.io/","docsMap",{"_191":192,"_193":194,"_195":26,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":26,"_207":26,"_208":26,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218,"_219":26,"_220":221,"_222":26,"_223":26,"_224":26,"_225":26,"_226":26,"_227":26,"_228":26,"_229":26,"_230":26,"_231":26,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243,"_244":26,"_245":26,"_246":26,"_247":26,"_248":249,"_250":26,"_251":252,"_253":254,"_255":256,"_257":256,"_258":259,"_260":26,"_261":26,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271},"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"]

Switch to a FIPS validated image with ease!