Skip to content
Search

GitHub Actions Runner

lastmod 2026-08-10created 2026-08-103 edits

The runner is the application that runs a job from a GitHub Actions workflow. It is used by GitHub Actions in the hosted virtual environments, or you can self-host the runner in your own environment.

Self-hosted runner

A Self-hosted Runner is a Github Actions feature that runs builds on local computing resources specified by the user. It is mainly useful when deployments are delayed because of a heavy deployment workload, or when server costs are a burden.

In the repository where you want to use Github Actions, go to "Settings - Actions - Runners" and click the "New self-hosted runner" button.

For x64, the install instructions are as follows: 

# Create a folder
$ mkdir actions-runner && cd actions-runner
# Download the latest runner package
$ curl -o actions-runner-linux-x64-2.336.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.336.0/actions-runner-linux-x64-2.336.0.tar.gz
# Optional: Validate the hash
$ echo "04cf0be1aff4c3ec3554466c39124ca250e3effd8873bb7e8d68535aa9505d5d  actions-runner-linux-x64-2.336.0.tar.gz" | shasum -a 256 -c
# Extract the installer
$ tar xzf ./actions-runner-linux-x64-2.336.0.tar.gz

Configure: 

# Create the runner and start the configuration experience
$ ./config.sh --url https://github.com/XXXX/YYYYY --token ZZZZ

Log output: 

--------------------------------------------------------------------------------
|        ____ _ _   _   _       _          _        _   _                      |
|       / ___(_) |_| | | |_   _| |__      / \   ___| |_(_) ___  _ __  ___      |
|      | |  _| | __| |_| | | | | '_ \    / _ \ / __| __| |/ _ \| '_ \/ __|     |
|      | |_| | | |_|  _  | |_| | |_) |  / ___ \ (__| |_| | (_) | | | \__ \     |
|       \____|_|\__|_| |_|\__,_|_.__/  /_/   \_\___|\__|_|\___/|_| |_|___/     |
|                                                                              |
|                       Self-hosted runner registration                        |
|                                                                              |
--------------------------------------------------------------------------------

# Authentication


√ Connected to GitHub

# Runner Registration

Enter the name of the runner group to add this runner to: [press Enter for Default] 

Enter the name of runner: [press Enter for spark-9234] 

This runner will have the following labels: 'self-hosted', 'Linux', 'ARM64' 
Enter any additional labels (ex. label-1,label-2): [press Enter to skip] 

√ Runner successfully added

# Runner settings

Enter name of work folder: [press Enter for _work] 

√ Settings Saved.

Run: 

$ ./run.sh

Output: 

√ Connected to GitHub

Current runner version: '2.336.0'
2026-08-10 00:13:58Z: Listening for Jobs

Using your self-hosted runner: 

# Use this YAML in your workflow file for each job
runs-on: self-hosted

Registering as a service (auto-start after reboot) 

sudo ./svc.sh install $USER
sudo ./svc.sh start
sudo ./svc.sh status

Unregistering the service (auto-start after reboot) 

sudo ./svc.sh stop
sudo ./svc.sh uninstall
./config.sh remove --token <제거용_토큰>

See also

Favorite site

author Zer0 sitemap