Changelog
Keep up with the latest features, fixes, and improvements for RunsOn.
v3.0.5
None
v3.0.2
Improved the Terraform Flex quickstart with a complete runnable VPC example, including private subnets, NAT Gateway, S3 gateway endpoint, optional EFS/ECR/admin routes, and the gettingstarted…
v3.0.1
Reduced provisioning broker log noise when recovered work queues are saturated by aggregating repeated enqueue failures into a single warning with backlog and capacity details.
v3.0.0
RunsOn v3 replaces the App Runner control plane with the new runtime on ECS/Fargate, using API Gateway/Lambda ingress and a simpler runtime service model. Added an integrated managed WAF option…
v2.12.6
Fixed EC2 Fleet generation for runner labels with multiple exact instance types and Spot, so exact family=a+b selectors use explicit instance-type overrides correctly. - Pools: dangling runner…
v2.12.5
Fix for magic cache scope. Fixes 474. Detect overlapping families and put them into the same group. Fixes 476.
v2.12.4
Fix a CloudFormation template issue that made the stack fail to upgrade when Private=only was set.
v2.12.3
Optimize magic cache save performance on large payloads (2GiB+) - Terraform module was incorrectly specifying an additional EBS volume for runners, leading to increased costs. Upgrade is…
v2.12.2
Spotlight: nested virtualization support on Windows and Linux for supported x64 runners (c8i, m8i, or r8i family). Enable it with the nested-virt label, disable it explicitly with…
v2.12.1
Fix Magic Cache regression when uploading large payloads. Fixes 460. - Add warning instead of failing when invalid family requirements are given. Fixes 462.
v2.12.0
OTEL integration on runners: you can now set extras=otel, and a local OTEL collector will be started on each runner, that will ship logs, traces, AND host metrics to your OTEL backend (if any).…
v2.11.0
Terraform/OpenTofu module available for testing. View https://github.com/runs-on/terraform-aws-runs-on for more details. Long term goal is to make the CloudFormation template the easy path for…
v2.10.1
Adds launch warnings to agents, introduces granular AWS/DynamoDB/S3/EC2 limiters with OTEL metrics, improves job/pool scheduling and GitHub/DynamoDB integrations (caching, batch deletes), and…
v2.10.0
Fix numerous bugs for pools (still in beta). New reconciliation loop should ensure that no queued job is left pending. FIFO semantics for SQS queues now enforced for job scheduling, even under…
v2.9.3
Fix stepsecurity integration. - Work around GitHub API returning outdated data when checking for deployment statuses. Possibly fixes 386. - Restore previous behavior for SSH, i.e. it is enabled by…
v2.9.2
Fix S3 rate-limit initialization and restore correct values. - Improve Slack webhook templates by @cfsnate. - Pool environment field renamed to env (to be coherent with the naming in runner…
v2.9.1
Note 2025-10-21: please use v2.9.2 instead, since it includes important fixes. - Fix pool overflow not picking the correct runner and image spec. - Warm and hot pools are available for Windows as…
v2.9.0
This is a large release, with many internal and external changes. Please review the first section below carefully. Note 2025-10-17: please use v2.9.2 instead, since it includes important fixes. -…
v2.8.9
Fix public subnet selection when using stack parameter Private=always. Previously, public subnets were wrongfully ignored. - Properly take into account main route table when using external…
v2.8.8
Increase Docker ECR setup timeout to 2min (previously 20s, but could lead to authentication errors).
v2.8.7
Small fix for the CloudFormation template, when using the external networking stack and not passing any public (or private) subnet IDs.
v2.8.6
Bug fixes, and first iteration on integrated CloudWatch dashboard for people managing the stack. - Better handling of environment variable display in the "Set up runner" step. Fixes 325. - Allow…
v2.8.5
Fix buildkit gha exporter, better user error reporting, AppRunner VPC connector integration. - Report non-retryable user errors directly in GitHub: whenever a job can't be started for user reasons…
v2.8.4
Integrated CPU/Memory/Disk/Network monitoring, integrated job-level cost reporting, official snapshot action release, and many QoL improvements. - Allow to send metrics to CWAgent namespace. This…
v2.8.3
Huge improvements to tagging, magic cache is now even faster, and bug fix for jobs tied to environments with no approval required. QoL improvements - Check if the spot role exists before starting…
v2.8.2
Support for EFS, TMPFS, and ECR ephemeral registry for fast docker builds. Also some bug fixes. EFS Embedded networking stack can now create an Elastic File System (EFS), and runners will…
v2.8.1
A large release: can now use external networking stack ; enable encryption on all S3 buckets ; lots of quality of life improvements and bug fixes ; halve Windows boot times and enable Cloudwatch…
v2.7.2
GHES support is now available. Allow to specify a custom expiration for objects in the cache bucket. - GHES support is now available. Fixes 250. - Add S3CacheExpirationInDays stack parameter.…
v2.7.1
Hotfix: fix for disk=large handling.
v2.7.0
A few minor breaking changes related to VPC flow logs and hdd label. Plus many fixes. This is a minor release, so this comes with the following breaking changes. Please review your CloudFormation…
v2.6.8
Hotfix for CreateFleet IdempotentParameterMismatch errors, as well as Magic Cache support for newer buildx versions. - Fixes 251: IdempotentParameterMismatch error. - Fix Magic Cache for newer…
v2.6.7
New spot circuit breaker for snoozing spot requests if too many interruptions detected. Monitoring improvements. StepSecurity integration, and more. Spot circuit breaker - Allow to switch to…
v2.6.6
Fix VpcEndpoints stack parameter. With VpcEndpoints enabled, the CloudFormation template was incorrectly assigning interface endpoints to both public and private subnets, while an interface…
v2.6.5
Optimized GPU images, new VpcEndpoints stack parameter, ability to specify custom instance tags for custom runners. Note: there appears to be some issues with the new VPC endpoints. I'm on it! If…
v2.6.4
CLI 0.0.1 released, fix for Magic Cache, fleet objects deletion. - CLI released: https://github.com/runs-on/cli. Allows to easily view logs (both server logs and cloud-init logs) for a workflow…
v2.6.3
Fix magic cache handling of actions/upload-artifact. Prepare for RunsOn CLI. - Store instance id assigned to job (once job has started) in the main S3 bucket (under…
v2.6.2
Magic transparent cache for dependencies and docker layers. SSM support for logging into runner instances. And more. - BETA - Transparent S3-backed caching for ALL actions that depend on the…
v2.6.1
New stack parameters and best practices compliance changes. No longer defaults to fetching global config when a local repo config is not found. Improve housekeeping to handle an additional AWS…
v2.6.0
Auto-retry mechanism for spot interruptions, SingleAZ or MultiAZ NAT gateways, and more! - Spot workflows are now retried once with an on-demand instance if interrupted. Fixes 160. Requires a…
v2.5.9
Fix GitHub webhook customproperties handling when non-string values.
v2.5.8
Revert x/time dependency to v0.6.0 since v0.7.0 introduced a breaking change for rate-limits when using a zero limit.
v2.5.7
Add Private=only mode, make EBS encryption opt-in, introduce disk label. Plus fixes and minor improvements. Note: please use v2.5.8+ because this version embeds a dependency upgrade for the…
v2.5.6
Enable IPv6 for runners. Allow to specify multiple static IPs for the managed NAT gateway. Allow filtering images based on tags. A lot of changes (again) around GitHub rate-limit handling and…
v2.5.5
Strengthen CF template configuration to better conform to AWS guidelines. Bug fixes. - Verify that generated JIT token has at least one char. - Do not attempt to retry runner creation when we know…
v2.5.4
New ubuntu24 images, new housekeeping task to auto-restart instances that failed to launch, new always-on Private setting, additional runner details in logs, and more. - Add ubuntu24 official…
v2.5.2
Summary: refactor rate-limits, fix housekeeping behaviour, add missing cost allocation tags, fix rare preinstall bug, unregister runner from github after job termination. - Refactor rate-limits,…
v2.5.1
New ubuntu24 images, additional runner details in logs, scheduling retry mechanism if internal AWS server error when launching, and more. Note: DO NOT USE this release. The new housekeeping…
v2.5.0
Summary: Allow to assign an environment name to each RunsOn stack. Allow to specify VPC CIDR block and export outputs to facilitate VPC peering connections. Allow to set custom tags on instances.…
v2.4.0
Summary: beta windows support, prometheus metrics, disk statistics in workflow logs. - Prometheus metrics export, every minutes, at /metrics (authenticated with Basic Auth and a new ServerPassword…
v2.3.2
Summary: a fix for useless creation of instances when hitting quota errors, reverting the unbounded cpu and ram change (from v2.3.0), and CloudWatch agent now streams instance logs into…
v2.3.1
Summary: Auto-mounting of ephemeral disks, improvements in dangling instance cleanup, better handling of preinstall. Local NVME disks (if any) are now automatically arranged in a RAID0 array, and…
v2.3.0
Summary: Allow setting custom spot allocation strategy, cpu and ram behaviour change, config file is now read from the current branch for private repositories. And 2 new regions! 1. Spot…
v2.2.4
Summary: properly handle jobs with environments attached. Note: this newer version requires a permission update for the accompanying GitHub app. You will receive an email after the upgrade with…
v2.2.3
Summary: make volume network throughput configurable, reduce alert noise for spot quota exceeded. And 1 new region! - new region: Sydney (ap-southeast-2). - make volume throughput configurable,…
v2.2.2
Summary: Add more tags to EC2 instances, and many fixes. Plus 2 new regions! London (eu-west-2) and Tokyo (ap-northeast-1) are now supported regions! - Adds runs-on-repo-full-name tag to…
v2.2.1
Summary: fix extends handling in config file. Fix repoconfig extends, allow custom policy for instance profile by @crohr in https://github.com/runs-on/runs-on/pull/64
v2.2.0
Summary: Private subnet support, new retry mechanism, spot interruption detection, bare-metal support, and many fixes and improvements. - New CloudFormation stack parameter Private (false by…
v2.1.0
Summary: full rewrite in Go, use external FIFO queue to keep jobs in flight. NodeJS = Go I switched the server to the Go language, for better concurrency control. NodeJS allowed me to put…
v2.0.13
Summary: switch to CreateFleet API, multi-az support, multi-region support + many fixes. Warning: this is a major release bump, with a new VPC being created. You are advised to upgrade either…
v1.7.4
Summary: handle conflict when registering runner. Retry registering runner if getting conflict due to octokit sdk retry by @crohr in https://github.com/runs-on/runs-on/pull/30 Remove non-ASCII…
v1.7.3
Summary: Reduce rate-limit issues, add m7i as additional family type for default runners. Plus 2 new regions! Official support for Frankfurt (eu-central-1) and Oregon (us-west-2) regions. Disable…
v1.7.2
Summary: IMDSv2 support, instant reload after first setup, add tags on instance and publish metrics. - instant reload after first setup - fix templates
v1.6.5
Summary: better error message when trying to launch EC2 instance. - Properly display the last error message from trying to launch an EC2 instance Full Changelog:…
v1.6.4
Summary: fix race-condition when updating the stack. Fix race-condition when updating the stack (https://github.com/runs-on/runs-on/pull/21) Full Changelog:…
v1.6.3
Summary: Fix error message when unable to launch a runner. Fix error message when unable to launch a runner
v1.6.2
Summary: avoid EC2 rate-limit issues. - Allow to set ec2 queue size from env variable, to avoid rate limit issues (RequestLimitExceeded). Reference from EC2:…
v1.6.1
Summary: Support for S3 backend for storing caches. New ubuntu22-full-arm64 image. Transparent actions caching on dedicated S3 bucket, for 5x speed and UNLIMITED cache sizes. See…
v1.5.0
Summary: Faster boot times, proper disk resizing, new licenses, better surfacing of internal timings right into the job log output. Faster boot for large images ubuntu22-full-x64:
v1.4.2
Summary: Allow overriding SSH admin selection Allow overriding SSH admin selection by @crohr in https://github.com/runs-on/runs-on/pull/11 See https://github.com/runs-on/runs-on/wiki/Upgrading for…
v1.4.1
Summary: Fix instance selection. Fix instance selection by @crohr in https://github.com/runs-on/runs-on/pull/10 Full Changelog: https://github.com/runs-on/runs-on/compare/v1.4.0...v1.4.1
v1.4.0
Summary: Send cost report and alerts via email, instead of GitHub issue. Add S3 gateway. And many fixes. Switch to SNS topic for alerts and costs by @crohr in…
v1.3.8
First official release 🎉