selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
actions-runner-controller logo

Self-host actions-runner-controller

gha-runner-scale-set-0.15.1

Kubernetes operator for autoscaling GitHub Actions runners

ReleaseOpen SourceApache-2.0
Updated2 weeks ago
LanguageGo
Setup difficultyAdvanced
Stars
6 644
Requires
Cert-manager, Helm 3, Kubernetes cluster
Docker
ghcr.io/actions/gha-runner-scale-set-controller
Install with Helm

What is actions-runner-controller?

This Kubernetes operator from the GitHub Actions team and community lets you run self-hosted Actions runners on your own Kubernetes infrastructure. It creates runner scale sets that automatically adjust based on workflow demand across repositories, organizations, or enterprises. Runners are ephemeral and container-based for fast scaling. Installation uses Helm charts from GitHub Container Registry. Authentication supports GitHub Apps or personal access tokens. The system requires cert-manager for webhook certificates and includes separate charts for the controller and runner scale sets.

actions-runner-controller alternatives

Should you self-host actions-runner-controller?

actions-runner-controller scores 70/100 on selfhost.directory (how scoring works) and ranks #7 of 28 in CI/CD. It has 6 644 GitHub stars, +98 in the last 30 days.

It shipped 6 stable releases in the past year. The latest, gha-runner-scale-set-0.15.1, came out on 23 October 2026. New versions land roughly every 5 weeks.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is jenkins (83/100, 26 756 stars). It scores higher overall, so compare the two before you pick. See actions-runner-controller vs jenkins side by side.

Features

  • Autoscaling runner scale sets
  • Custom volumes support
  • Ephemeral container-based runners
  • GitHub App Authentication
  • Kubernetes operator pattern
  • Personal Access Token Authentication
  • Repository, organization, and enterprise runner registration
  • Runner groups support
  • Windows runner support

actions-runner-controller README

Actions Runner Controller (ARC)

CII Best Practices awesome-runners Artifact Hub

About

Actions Runner Controller (ARC) is a Kubernetes operator that orchestrates and scales self-hosted runners for GitHub Actions.

With ARC, you can create runner scale sets that automatically scale based on the number of workflows running in your repository, organization, or enterprise. Because controlled runners can be ephemeral and based on containers, new runner instances can scale up or down rapidly and cleanly. For more information about autoscaling, see "Autoscaling with self-hosted runners."

How to install actions-runner-controller

Install actions-runner-controller with Helm

NAMESPACE="arc-systems" helm install arc
--namespace "${NAMESPACE}"
--create-namespace
oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set-controller

Installs the controller CRDs and operator

actions-runner-controller releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in CI/CD

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…