Changelog

Keep up with the latest features, fixes, and improvements for RunsOn.

· 1 min read

v3.0.5

None

· 1 min read

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…

· 1 min read

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.

· 2 min read

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…

· 1 min read

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…

· 1 min read

v2.12.5

Fix for magic cache scope. Fixes 474. Detect overlapping families and put them into the same group. Fixes 476.

· 1 min read

v2.12.4

Fix a CloudFormation template issue that made the stack fail to upgrade when Private=only was set.

· 1 min read

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…

· 2 min read

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…

· 1 min read

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.

· 4 min read

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).…

· 2 min read

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…

· 1 min read

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…

· 2 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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…

· 9 min read

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

· 1 min read

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…

· 1 min read

v2.8.8

Increase Docker ECR setup timeout to 2min (previously 20s, but could lead to authentication errors).

· 1 min read

v2.8.7

Small fix for the CloudFormation template, when using the external networking stack and not passing any public (or private) subnet IDs.

· 2 min read

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…

· 1 min read

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…

· 2 min read

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…

· 2 min read

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…

· 4 min read

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…

· 3 min read

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…

· 1 min read

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

· 1 min read

v2.7.1

Hotfix: fix for disk=large handling.

· 2 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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…

· 2 min read

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…

· 2 min read

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…

· 1 min read

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…

· 1 min read

v2.5.9

Fix GitHub webhook customproperties handling when non-string values.

· 1 min read

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.

· 1 min read

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…

· 2 min read

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…

· 1 min read

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…

· 2 min read

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…

· 1 min read

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,…

· 2 min read

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…

· 2 min read

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

· 1 min read

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…

· 2 min read

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…

· 2 min read

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…

· 2 min read

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…

· 1 min read

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…

· 1 min read

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,…

· 2 min read

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…

· 1 min read

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

· 4 min read

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…

· 4 min read

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…

· 3 min read

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…

· 1 min read

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…

· 1 min read

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…

· 1 min read

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

· 1 min read

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:…

· 1 min read

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:…

· 1 min read

v1.6.3

Summary: Fix error message when unable to launch a runner. Fix error message when unable to launch a runner

· 1 min read

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:…

· 1 min read

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…

· 1 min read

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:

· 1 min read

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…

· 1 min read

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

· 1 min read

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…

· 1 min read

v1.3.8

First official release 🎉