Documentation
RunsOn comes as a CloudFormation stack + on-premise Go service, which starts ephemeral runners for your GitHub Action workflows.
Everything runs in your AWS account.
This is a drop-in replacement for official or third-party GitHub Action runners.
![Architecture](/_astro/runs-on-arch-X.ln3RoOLG_Z1Yp6LW.webp)
I’m currently gauging interest in other platform support (MacOS / Windows). Please fill out this form ↗ if interested!
Use cases
Using self-hosted runners can be useful if:
- your developers are frustrated with long wait times for test suites or compilations;
- your bill for GitHub runners starts to trigger enquiries from finance;
- you need runners with a higher number of CPUs / RAM / Disk / Architecture / GPU support, than what GitHub offers.
- you want runners running in your own AWS account with specific public IPs (coming soon) so that you can whitelist them in external services;
- you already use a self-hosted runner solution, but need something simpler and maintenance-free.
Features
Runner types Learn how to configure your GitHub Actions runners with specific requirements in terms of CPU, GPU, RAM, HDD size, and more.
Runner images RunsOn provides compatible images with official GitHub Actions runners, but you can also bring your own images if you want!
Configuration file Learn all about .github/runs-on.yml configuration file
Cost and alert report Learn how RunsOn makes sure no dangling resources are left, and alerts you whenever something goes wrong.
GPU runners with GitHub Actions Learn how to launch 10x cheaper NVIDIA or AMD GPU runners with GitHub Actions and RunsOn.
S3 cache for GitHub Actions Use an S3 bucket as a cache backend for your actions, to enjoy faster download and upload speeds + unlimited cache sizes
Security Take self-hosted runner security seriously
Spot instances Learn how to save hundreds of dollars on GitHub Action runners with RunsOn and spot instances
SSH access RunsOn provides a dedicated SSH console to access your GitHub Action runners, for easy troubleshooting.
Static IPs Learn how RunsOn can be configured with static IPs for GitHub Action runners, ensuring secure, compliant, and reliable CI/CD workflows.
Guides
Building a custom AMI with Packer Learn how to build a custom AMI using Packer to prepopulate with your software, ensure compliance, and control over your AWS workflows.
Installation Guide Install RunsOn in your own infrastructure, and get 10x cheaper GitHub Action runners.
Troubleshooting Troubleshoot your RunsOn installation
Upgrade Guide Learn how to upgrade RunsOn.
Updating GitHub App Permissions Learn how to manually update permissions for your GitHub App when a RunsOn upgrade requires new permissions.