Checking the status of self-hosted runners

You can check the status of a self-hosted runner from your repository settings on GitHub, or directly on a self-hosted runner machine.

In this article:

Checking the status of a self-hosted runner using GitHub

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

  2. Under your repository name, click Settings.

    Repository settings button

  3. In the left sidebar, click Actions.

    Actions setting

  4. Under "Self-hosted runners," you can view a list of runners registered with your repository. You can see the runner name and its status.

    Runner list

    The status can be one of the following:

    • Idle: The runner is connected to GitHub and is ready to execute jobs.
    • Active: The runner is currently executing a job.
    • Offline: The runner is not connected to GitHub. This could be because the machine is offline, the self-hosted runner application is not running on the machine, or the self-hosted runner application cannot communicate with GitHub.

Checking the status of a self-hosted runner on the machine

The self-hosted runner application can be run as an interactive process, or as a service in the background.

You can also find detailed logs in the _diag folder of the self-hosted runner application.

Checking the status of an interactive self-hosted runner process

If the self-hosted runner application is running as an interactive process, you can check its status by inspecting the application's output.

The following list shows some example outputs.

  • The self-hosted runner application has started and is connected to GitHub:

    √ Connected to GitHub
    
    2019-10-24 05:45:56Z: Listening for Jobs
  • The runner is executing a job:

    2019-10-25 00:43:49Z: Running job: Awesome_Octocat
  • The runner has completed a job:

    2019-10-25 00:44:09Z: Awesome_Octocat completed with result: Succeeded

Checking the status of a self-hosted runner service

If you're running the self-hosted runner application as a service, you can check its status with a command specific to your machine's operating system. See "Configuring the self-hosted runner application as a service", to find the command under "Checking the status of the service" for your operating system.

Ask a human

Can't find what you're looking for?

Contact us