Section: Choosing and targeting runners

Target a self-hosted runner

yaml
yaml
runs-on: [self-hosted, linux, x64]
Explanation

Self-hosted runners are useful for private networks, special hardware, or custom tooling.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Choosing and targeting runners
Use a GitHub-hosted Ubuntu runner
Run a job on Linux.
OpenIn sheetyamlsame section
Run the job inside a container
Use a container image as the job runtime.
OpenIn sheetyamlsame section
Start a Redis service for tests
Use a service container for integration or cache tests.
Label-based runner targeting
Match jobs to specialized self-hosted infrastructure.
Inspect the workspace path
Print the checkout path on the runner.