...
On GitHub, navigate to the main page of the organization.
Under your organization name, click Settings.
In the left sidebar, click Actions.
Under "Self-hosted runners," click Add new, then click New runner.
Select the operating system and architecture of your self-hosted runner machine.
You will see instructions showing you how to download the runner application and install it on your self-hosted runner machine.
Open a shell on your self-hosted runner machine and run each shell command in the order shown.
Note: On Windows, if you want to install the self-hosted runner application as a service, you must open a shell with administrator privileges. We also recommend that you use
C:\actions-runneras the directory for the self-hosted runner application so that Windows system accounts can access the runner directory.The instructions walk you through completing these tasks:
- Downloading and extracting the self-hosted runner application.
- Running the
configscript to configure the self-hosted runner application and register it with GitHub Actions. Theconfigscript requires the destination URL and an automatically-generated time-limited token to authenticate the request.- On Windows, the
configscript also asks if you would like to install the self-hosted runner application as a service. For Linux and macOS, you can install a service after you finish adding the runner. For more information, see "Configuring the self-hosted runner application as a service."
- On Windows, the
- Running the self-hosted runner application to connect the machine to GitHub Actions.
Configureing as a Service
- Stop the self-hosted runner application if it is currently running.
Install the service
Start Start the service
Check Check the status of the service
| Code Block | ||
|---|---|---|
| ||
sudo ./svc.sh stop sudo ./svc.sh install sudo ./svc.sh start sudo ./svc.sh status |
| ||
|
Checking that your self-hosted runner was successfully added
...
For more information, see "Monitoring and troubleshooting self-hosted runners."
Checking the status of a self-hosted runner
Related articles
Adding a self-hosted runner to a repository
...
Configuring the self-hosted runner application as a service
...
Monitoring and troubleshooting self-hosted
...
runners
| Code Block | ||
|---|---|---|
| ||
|



