https://github.com/runs-on/runs-on
Self-hosted GitHub Actions runners made simple. For AWS. 10x cheaper, 40% faster, and unlimited caching. Best alternative to Actions Runner Controller.
https://github.com/runs-on/runs-on
aws ci cicd cloudformation continuous-delivery continuous-deployment continuous-integration ec2-spot github-actions github-runners on-premise self-hosted self-hosted-runners
Last synced: about 2 months ago
JSON representation
Self-hosted GitHub Actions runners made simple. For AWS. 10x cheaper, 40% faster, and unlimited caching. Best alternative to Actions Runner Controller.
- Host: GitHub
- URL: https://github.com/runs-on/runs-on
- Owner: runs-on
- License: mit
- Created: 2023-12-09T12:44:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-08T08:10:21.000Z (about 2 months ago)
- Last Synced: 2026-04-08T10:14:40.643Z (about 2 months ago)
- Topics: aws, ci, cicd, cloudformation, continuous-delivery, continuous-deployment, continuous-integration, ec2-spot, github-actions, github-runners, on-premise, self-hosted, self-hosted-runners
- Homepage: https://runs-on.com
- Size: 1.33 MB
- Stars: 1,170
- Watchers: 11
- Forks: 42
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-runners - runs-on/runs-on - on/runs-on.svg)](https://github.com/runs-on/runs-on/blob/master/LICENSE) [](https://github.com/runs-on/runs-on/graphs/contributors/) [](https://github.com/runs-on/runs-on/stargazers/) [](https://GitHub.com/runs-on/runs-on/issues/) [](https://GitHub.com/runs-on/runs-on/issues?q=is%3Aissue+is%3Aclosed) | AWS EC2 | ✅ | Repo, Dynamic Labels | On-demand | ✅ | x86, AMD64, ARM64 | ✅ | No PAT, only JIT token | Auto-cleanup | No runtime privilege | GitHub App exposed | AllInOne and custom images possible | yes (Actions Workflow) | $15/month | (The matrix (might be better readable on [GitHub pages](https://jonico.github.io/awesome-runners/)) / A word about self-hosted action runner images / virtual environments and how to test locally)
- stars - runs-on/runs-on - Self-hosted GitHub Actions runners made simple. For AWS. 10x cheaper, 40% faster, and unlimited caching. Best alternative to Actions Runner Controller. \[*MIT License*\] (⭐️1185) (Unknown)
README
# RunsOn: faster, cheaper GitHub Actions runners in your AWS account
**Cut CI spend, speed up builds, and keep your runner infrastructure fully under your control.**
RunsOn gives you self-hosted GitHub Actions runners that run in your own AWS account, with fast startup, strong isolation, and the flexibility to use the instance types, networking model, and images that fit your workloads. Think of it as a strong alternative to Actions Runner Controller (ARC) on Kubernetes, the Philips Terraform module, or third-party runner providers that require broad access to your code and secrets.
## Why RunsOn
- ✅ **Cheaper**. RunsOn is designed to reduce the cost of GitHub Actions dramatically, often by [7x to 15x](https://runs-on.com/pricing/) compared to GitHub-hosted runners.
- ✅ **Faster**. Raw [CPU performance is up to 30% higher](https://runs-on.com/benchmarks/github-actions-runners/) than official GitHub-hosted runners.
- ✅ **Fully owned by you**. RunsOn installs into your AWS account and uses a private GitHub App created for your organization during setup.
- ✅ **Compatible with real workflows**. Keep using GitHub Actions, choose from [public AMIs for AWS](https://github.com/runs-on/runner-images-for-aws), or [bring your own image](https://runs-on.com/features/byoi/).
- ✅ **Low maintenance**. Install and upgrade from a single [CloudFormation template](./cloudformation/template.yaml) and related public templates in this repository.
## Install
Use the [installation guide](https://runs-on.com/guides/install/) to deploy RunsOn in about 10 minutes.
This public repository publishes the CloudFormation install assets and a small set of public-facing supporting files for RunsOn. Product docs, install guidance, architecture details, and pricing live on [runs-on.com](https://runs-on.com/).
- Primary guide: [Install RunsOn](https://runs-on.com/guides/install/)
- Architecture overview: [RunsOn architecture](https://runs-on.com/architecture/)
## Usage
Before:
```yaml
runs-on: ubuntu-latest
```
After:
```yaml
runs-on: "runs-on=${{ github.run_id }}/runner=2cpu-linux-x64"
```
See the [job labels documentation](https://runs-on.com/configuration/job-labels) for runner sizing, images, environments, and other configuration options.
## Features
- [Linux](https://runs-on.com/runners/linux), [Windows](https://runs-on.com/runners/windows), and [GPU](https://runs-on.com/runners/gpu) runner support.
- Ephemeral VMs per job, with [spot pricing](https://runs-on.com/features/spot-instances/) and automatic on-demand fallback.
- Multi-AZ and multi-[environment](https://runs-on.com/configuration/environments/) support.
- Faster, larger, and cheaper caching with the built-in [S3 cache backend](https://runs-on.com/caching/s3-cache-for-github-actions/).
- Optional [SSH access](https://runs-on.com/networking/ssh/) and [static IPs](https://runs-on.com/networking/static-ips/) for controlled networking setups.
- Built-in [cost and alert reporting](https://runs-on.com/features/cost-and-alert-report/) and [Magic Caching](https://runs-on.com/caching/magic-cache/).
## Screenshots
**Node.js CI build across different providers**
**Stable queue times under large bursts**
**Much faster caches**
**Job metadata and timings**
## License
This repository contains public MIT-licensed RunsOn assets, including the CloudFormation templates published here.
Commercial licensing, product access, and additional licensing details are described on the [pricing page](https://runs-on.com/pricing/). This public repository is not the private source-of-truth monorepo for RunsOn.
## Learn More
- [About RunsOn](https://runs-on.com/about/)
- [Documentation](https://runs-on.com/docs/)
- [Pricing](https://runs-on.com/pricing/)
- [Cyril Rohr](https://cyrilrohr.com)