This guide covers everything from the initial download to long-term management. 1. Prerequisites and System Requirements
Run these commands in your terminal to create a directory and download the latest runner package: Self-hosted runners reference - GitHub Docs
GitHub Actions self-hosted runners allow you to use your own infrastructure for CI/CD, providing greater control over the hardware, operating system, and software tools used in your workflows. While GitHub-hosted runners are convenient, self-hosted runners are essential for jobs requiring private network access, custom hardware (like GPUs), or larger resource allocations than the standard 7 GB RAM. github actions self hosted runner download
Below are the standard installation patterns for the three major operating systems. Linux Download & Installation
Click (for repositories, this is in the top tab; for organizations, it's in the left sidebar). In the left sidebar, click Actions > Runners . Click the New self-hosted runner button. Step 2: Choose Your Platform This guide covers everything from the initial download
Select the (Linux, macOS, or Windows) and the Architecture (e.g., x64 or ARM64). GitHub will display a list of download and configuration commands tailored to your selection. 3. Platform-Specific Installation Commands
Linux (Ubuntu 20.04+, RHEL 8+), Windows (Server 2019+), or macOS (11+). Architecture: x64, ARM, or ARM64. In the left sidebar, click Actions > Runners
Recommended minimum of 2 CPU cores and 4 GB RAM (70 kbps upload/download speed required).