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.
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 set your runner CPU, RAM, and HDD size at runtime, depending on your workflow requirements.
Runner images Learn how to set your runner image, including using your own custom AMIs.
S3 cache for GitHub Actions Learn how to use an S3 bucket as a cache backend for your actions, to enjoy 5x throughput and unlimited cache sizes!
Cost and alert report Learn how RunsOn makes sure no dangling resources are left, and alerts you whenever something goes wrong.
Security Take self-hosted runner security seriously
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
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.
Reference
GitHub Actions Providers Benchmark Compare CPU speeds and queuing times of RunsOn / GitHub / Warpbuild / Buildjet / Ubicloud / Blacksmith action runners, for the fastest workflow builds!
AWS EC2 Instances Benchmark Compare CPU speed, pricing, and spot interruption percentages of most EC2 instance types.
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.
Configuration file Learn all about .github/runs-on.yml configuration file
Caching Learn how to use the integrated S3 caching on RunsOn, to greatly speed up dependency installation as well as docker builds
Spot instances Learn how to save hundreds of dollars on GitHub Action runners with RunsOn and spot instances