Configuration Guide

RunsOn provides extensive configuration options to customize runners for your specific needs.

Configuration Options

Job Labels Configure CPU, RAM, instance family, volume size, and more per-job using runs-on labels.

Stack Configuration CloudFormation stack parameters for organization-wide settings.

Custom Images Build and use your own AMIs with pre-installed dependencies.

Spot Instances Use AWS Spot instances for up to 90% cost savings on interruptible workloads.

Environments Configure multiple environments for dev, staging, and production workflows.

Repository Config Per-repository settings via .runs-on.yml configuration file.

Resource Tags Add custom AWS tags to runners for cost allocation and tracking.

Quick Example

Customize runners per-job using labels:

jobs:
  build:
    runs-on: runs-on=${{ github.run_id }}/cpu=4/ram=16/family=m7a+m7i-flex
    steps:
      - run: echo "Running on 4 vCPUs with 16GB RAM"

See Job Labels for all available options.