What is the runs-on label?
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.
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
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/