CI Runnerscirunners.org
Glossary

What is the runs-on label?

Answer in brief

The line in a GitHub Actions job that names the kind of runner the job needs; changing it is how a workflow moves to another runner provider.

By the CI Runners editors · Updated

runs-on label in CI

Every job in a GitHub Actions workflow has a runs-on key. Its value is one or more labels, or a runner group. GitHub routes the job to an idle runner that carries all of those labels: ubuntu-latest goes to a GitHub-hosted runner, while a label registered by a self-hosted runner goes to that runner.

Third-party runner vendors publish their own labels, which usually encode the size, architecture and image, so adopting one means installing its GitHub App and editing this one line per job. Moving back is the same edit in reverse.

Sources

  1. docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax

Check before you rely on it. Products change quickly, and this page reflects public documentation as of November 22, 2026. Confirm anything that matters in the provider’s own documentation.

Cite this page

CI Runners. (2026). What is the runs-on label?. cirunners.org. Last reviewed November 22, 2026. https://cirunners.org/glossary/runs-on/