Repository files navigation

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."

You can set up ARC on Kubernetes using Helm, then create and run a workflow that uses runner scale sets. For more information about runner scale sets, see"Deploying runner scale sets with Actions Runner Controller."

Actions Runner Controller (ARC) is an open-source project currently developed and maintained in collaboration with the GitHub Actions team, external maintainers @mumoshu and @toast-gear, variouscontributors, and theawesome community.

If you think the project is awesome and is adding value to your business, please consider directly sponsoringcommunity maintainers and individual contributors via GitHub Sponsors.

If you are already the employer of one of the contributors, sponsoring via GitHub Sponsors might not be an option. Just support them by other means!

Seethe sponsorship dashboard for the former and the current sponsors.

To give ARC a try with just a handful of commands, please refer to theQuickstart guide.

For an overview of ARC, please refer toAbout ARC.

With the introduction ofautoscaling runner scale sets, the existingautoscaling modes are now legacy. The legacy modes have certain use cases and will continue to be maintained by the community only.

For further information on what is supported by GitHub and what's managed by the community, please refer tothis announcement discussion.

ARC documentation is available ondocs.github.com.

The following documentation is for the legacy autoscaling modes that continue to be maintained by the community:

• Quickstart guide
• About ARC
• Installing ARC
• Authenticating to the GitHub API
• Deploying ARC runners
• Adding ARC runners to a repository, organization, or enterprise
• Automatically scaling runners
• Using custom volumes
• Using ARC runners in a workflow
• Managing access with runner groups
• Configuring Windows runners
• Using ARC across organizations
• Using entrypoint features
• Deploying alternative runners
• Monitoring and troubleshooting

We welcome contributions from the community. For more details on contributing to the project (including requirements), please refer to "Getting Started with Contributing."

We are very happy to help you with any issues you have. Please refer to the "Troubleshooting" section for common issues.