Page History

...

You can add self-hosted runners at the organization level, where they can be used to process jobs for multiple repositories in an organization. To add a self-hosted runner to an organization, you must be an organization owner.

1. On GitHub, navigate to the main page of the organization.

2. Under your organization name, click  Settings.

   Image Modified

    

3. In the left sidebar, click Actions.

   Image Modified

    

4. Under "Self-hosted runners," click Add new, then click New runner.

5. Select the operating system and architecture of your self-hosted runner machine.

   Image Modified

    

6. 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-runner as 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 config script to configure the self-hosted runner application and register it with GitHub Actions. The config script requires the destination URL and an automatically-generated time-limited token to authenticate the request.
     • On Windows, the config script 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."
   • Running the self-hosted runner application to connect the machine to GitHub Actions.
     Image Modified
     
     

7. Configureing as a Service

    
   
   
    Stop the self-hosted runner application if it is currently running.

    Install the service     Start the service    Check the status of the service

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

...

How to use GitHub Actions with your own self-hosted runner (aka build agent)

Configuring the self-hosted runner application as a service

Adding a self-hosted runner to a repository or an organization

...

...