The official GitHub Actions self-hosted runners documentation is split across two GitHub Docs pages: "Self-hosted runners" (concepts) and "Self-hosted runners reference" (requirements, routing, autoscaling, communication). As of November 2026, those pages state that a runner needs a supported OS (macOS 11.0 Big Sur or later, Ubuntu 20.04 or later, Windows 10 64-bit or later and more), must be online and idle to receive a job, gets a job re-queued if it does not pick it up within 60 seconds, and that any job left queued for more than 24 hours fails. This reference collects those facts with the exact commands, then shows how to keep a runner online, how to cut self-hosted runner startup time with a warm pool, and when a hosted Linux runner at $0.001 a minute replaces the fleet entirely.
Where the GitHub Actions self-hosted runners documentation lives
These are the GitHub Docs pages an engineer needs, by topic:
Self-hosted runners (concepts): what a self-hosted runner is, and the repository, organization and…