Deploy GitHub Actions runner scale sets on Kubernetes with Actions Runner Controller (ARC)

domain: docs.github.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Install the ARC controller Helm chart: helm install arc --namespace arc-systems --create-namespace oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set-controller
  2. Create a Kubernetes secret holding a GitHub App private key or a PAT with repo/org scope, then reference it in your scale-set values file
  3. Install a runner scale set Helm chart, setting githubConfigUrl to your repo or org URL and githubConfigSecret to the secret name: helm install arc-runners --namespace arc-runners --create-namespace -f values.yaml oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set
  4. In values.yaml set minRunners and maxRunners to control the autoscaling bounds, and set runnerScaleSetName to the label workflows will reference in runs-on
  5. Target the scale set from a workflow with runs-on: arc-runners (matching runnerScaleSetName); ARC provisions a runner pod per queued job and terminates it after completion
  6. Monitor scale-set activity with kubectl logs -n arc-systems deployment/arc-gha-runner-scale-set-controller and check runner pod status in the arc-runners namespace

Known gotchas

Related routes

Provision ephemeral namespace-per-PR environments using GitHub Actions and kubectl
docs.github.com/actions · 6 steps · unrated
Register a GitHub Actions self-hosted runner with custom labels and target it from a workflow
docs.github.com · 6 steps · unrated
Configure Dagster+ branch deployments with automated asset graph validation in CI on pull requests
docs.dagster.io · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans