GitHub-hosted

Using GitHub's own runners as a provider, and keeping an eye on minutes.

View as Markdown For AI agents

GitHub

GitHub's own hosted runners, billed per minute in private repos.

Labels: ubuntu-*, windows-*, macos-*, or a larger runner's own name
Example: runs-on: ubuntu-latest
Links: Docs

GitHub-hosted runners are the usual fallback: always available, and billed against your plan.

Use it

Name a GitHub-hosted label in the relay’s github input, usually the job’s old runs-on:

relay-test:
  uses: relayrunner/actions/.github/workflows/relay.yml@v1
  with:
    machine: self-hosted
    github: ubuntu-latest

Keep GitHub-hosted in your runner order, usually last. A step with no limit always takes a job that names a github label, so it’s a safe last resort.

Minutes

GitHub bills private repos by the minute, rounded up per job, and each plan includes some minutes a month. Standard runners in public repos are free. macOS minutes cost about ten times Linux minutes.

A GitHub-hosted step can carry a minutes limit, such as “while under 80%”. It then only takes jobs while the job’s GitHub account has used less than that share of its included minutes. Put another step after it to catch the rest. See Spend controls.

The Usage page shows each account’s minutes next to what your jobs would have cost. See the minutes limit for how it’s read.