With self-hosted runners, you can create custom hardware configurations that meet your needs with processing power or memory to run larger jobs, install software available on your local network, and choose an operating system not offered by GitHub-hosted runners. — GitHub Docs
Go to your repository on GitHub, then navigate to Settings > Actions > Runners and click New self-hosted runner.
Select the operating system and architecture that matches your device. Note that the architecture depends on your device specifications (e.g.,
x64).All required commands are shown on the same page where you selected the Runner Image and Architecture.
Programmatically assigning labels to a self-hosted runner is optional.
name: Test runner
on:
push:
jobs:
build:
runs-on: ["self-hosted"]
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: List directory
run: ls
You can configure the self-hosted runner application as a service so it starts automatically on boot.