Skip to main content

Removing self-hosted runners

You can permanently remove a self-hosted runner from a repository or organization.

Removing a runner from a repository

Note: Este procedimento remove permanentemente o executor auto-hospedado. Caso você deseje apenas impedir temporariamente que um executor seja atribuído a trabalhos, desligue o computador ou interrompa o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você o reinicie usando o aplicativo run.

A self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 14 days.
An ephemeral self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 1 day.

To remove a self-hosted runner from a user repository you must be the repository owner. For an organization repository, you must be an organization owner or have admin access to the repository. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see "Self-hosted runners."

Como alternativa, se você não tiver acesso ao repositório ou à organização no GitHub para remover um executor, mas desejar reutilizar o computador do executor, exclua o arquivo .runner dentro do diretório do aplicativo do executor auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

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

  2. Abaixo do nome do repositório, clique em Configurações. Botão Configurações do repositório

  3. In the left sidebar, click Actions, then click Runners.

  4. Na lista de executores, clique no executor que deseja configurar.

  5. Clique em Remover.

  6. Você verá instruções para remover o executor auto-hospedado. Complete qualquer um dos seguintes passos para remover o executor, dependendo se ele ainda está acessível:

    • Se você tiver acesso ao computador do executor: siga as instruções na tela para que o sistema operacional do computador execute o comando de remoção. As instruções incluem a URL necessária e um token gerado automaticamente, limitado por tempo.

      O comando de remoção executa as seguintes tarefas:

      • Remove o executor de GitHub.
      • Remove todos os arquivos de configuração do aplicativo de executor auto-hospedado na máquina.
      • Remove todos os serviços configurados se não estiver em execução no modo interativo.
    • Se você não tiver acesso ao computador: clique em Forçar a remoção deste executor para forçar o GitHub a remover o executor.

Removing a runner from an organization

Note: Este procedimento remove permanentemente o executor auto-hospedado. Caso você deseje apenas impedir temporariamente que um executor seja atribuído a trabalhos, desligue o computador ou interrompa o aplicativo run. O executor permanecerá atribuído em um estado "Offline" e não executará nenhum trabalho até que você o reinicie usando o aplicativo run.

A self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 14 days.
An ephemeral self-hosted runner is automatically removed from GitHub if it has not connected to GitHub Actions for more than 1 day.

To remove a self-hosted runner from an organization, you must be an organization owner. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see "Self-hosted runners."

Como alternativa, se você não tiver acesso ao repositório ou à organização no GitHub para remover um executor, mas desejar reutilizar o computador do executor, exclua o arquivo .runner dentro do diretório do aplicativo do executor auto-hospedado. Isso permite que o runner seja registrado sem ter que baixar novamente o aplicativo do runner auto-hospedado.

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

  2. No nome da sua organização, clique em Configurações. Botão Configurações da organização

  3. In the left sidebar, click Actions, then click Runners.

  4. Na lista de executores, clique no executor que deseja configurar.

  5. Clique em Remover.

  6. Você verá instruções para remover o executor auto-hospedado. Complete qualquer um dos seguintes passos para remover o executor, dependendo se ele ainda está acessível:

    • Se você tiver acesso ao computador do executor: siga as instruções na tela para que o sistema operacional do computador execute o comando de remoção. As instruções incluem a URL necessária e um token gerado automaticamente, limitado por tempo.

      O comando de remoção executa as seguintes tarefas:

      • Remove o executor de GitHub.
      • Remove todos os arquivos de configuração do aplicativo de executor auto-hospedado na máquina.
      • Remove todos os serviços configurados se não estiver em execução no modo interativo.
    • Se você não tiver acesso ao computador: clique em Forçar a remoção deste executor para forçar o GitHub a remover o executor.

Removing a runner from an enterprise

If you use GitHub Enterprise Cloud, you can also remove runners from an enterprise. For more information, see the GitHub Enterprise Cloud documentation.