Actions Runner Controller

Actions Runner Controller (ARC) is a Kubernetes operator that creates and auto-scales ephemeral self-hosted runners for GitHub Actions in your cluster.

  • Development
  • Infrastructure
  • Tools & Utilities
Actions Runner Controller (ARC) is a Kubernetes operator that creates and auto-scales ephemeral self-hosted runners for GitHub Actions in your cluster. Runners scale up and down as queued job counts change, so developers and teams can run continuous-integration workloads on Kubernetes with on-demand runners instead of dedicated machines.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

65/100 Good

Maintained
100last commit 2 days ago
Popular
766,678 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
201 serious finding, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
6,678
Open issues
400
Last commit
2026-11-19
Latest release
gha-runner-scale-set-0.15.1
License
Apache-2.0
Activity
declining

Checked today - source: GitHub (actions/actions-runner-controller)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Set GitHub App details before getting token If the runner uses GitHub App login, fill in APP_ID, APP_PRIVATE_KEY (the secret key for the GitHub App), and APP_LOGIN before the token step, or the script can't get the short-lived key GitHub uses for permission and the runner can't log in. source
  • Install the controller before creating runners Deploy the ARC controller first (e.g. via its Helm chart). Once it is running, create a runner scale set with a registered GitHub token; ARC then registers and autoscales self-hosted runners for your repository, organization, or enterprise. source
  • Install with Helm Deploy the controller using its Helm chart before creating runner scale sets. source

Fetched 3 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can ARC automatically scale runner sets based on workflow demand?

Yes. ARC can create runner scale sets that automatically scale based on the number of workflows running in your repository.

Are the ARC monitoring and troubleshooting docs for the current autoscaling mode?

No. The monitoring and troubleshooting documentation covers legacy ARC mode. It says autoscaling runner scale set documentation is available in GitHub Docs.

What should I check when ARC cannot bring up runner pods?

Check the ARC controller logs by running kubectl -n {namespace} logs actions-runner-controller-c manager in the ARC namespace.

Where can I find GitHub's guidance for hosting runners with ARC?

GitHub Docs describes using Actions Runner Controller to host your own runners in a Kubernetes cluster.

Answers sourced from docs.github.com, github.com, github.com, www.reddit.com

Community

Collected 48 days ago - public community threads