Manage GitHub repository access with the Azure Boards app

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

Once you install the Azure Boards app for GitHub, you can change the configuration and suspend operations. You can also uninstall the app. To learn more about Azure Boards and GitHub, see GitHub integration overview.

Note

With the Azure Boards app for GitHub, Azure Boards and Azure DevOps Services support integration with GitHub.com and GitHub Enterprise Server repositories. Integration with other Git repositories is not supported.

Note

With the Azure Boards app for GitHub, Azure DevOps Servers 2019 and later versions support integration with GitHub Enterprise Server repositories. Integration with other Git repositories is not supported.

Prerequisites

The procedures provided in this article only apply when you've installed the Azure Boards app for GitHub. For details, see Install and configure the Azure Boards app for GitHub.

  • To manage the Azure Boards integration, you must be the owner or administrator of the GitHub organization. You can connect to multiple GitHub repositories so long as you're an administrator for those repositories.

Change repository access

  1. Sign into the web portal for your GitHub organization and open Account settings.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Choose Installed GitHub Apps and then Configure next to Azure Boards.
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    The Azure Boards configuration page opens.

  3. Scroll down to the Repository access section.

  4. Choose the option you want, All repositories or Only select repositories.

    If you choose Only select repositories, select the repositories you want to participate in integration with Azure Boards.

    Screenshot of Repository access, choose Only select repositories.

  5. Choose Save when done.

Suspend or uninstall Azure Boards integration

  1. Starting from step 2 in the previous procedure, scroll down to the Danger zone section.

    Screenshot of Azure Boards configuration, Danger zone section.

  2. To suspend the integration, choose Suspend. From the popup confirmation window, choose OK to confirm the suspension.

    Screenshot of suspension confirmation.

    To unsuspend the integration, choose Unsuspend.

  3. To uninstall the Azure Boards app, choose Uninstall, and then choose OK from the popup confirmation window.

    Screenshot of uninstall confirmation.

Update Azure Boards' GitHub connections

If you change the repositories that the Azure Boards app for GitHub supports, you may be redirected to Azure Boards GitHub connections. A good practice is to remove the repositories in Azure Boards that can no longer connect to GitHub. For details, see Add or remove GitHub repositories.

If you uninstall the Azure Boards app for GitHub, you'll see the following message in Azure Boards, Project Settings>GitHub Connections. Choose Remove connection to remove all GitHub connections that have been previously made. See also, Add or remove GitHub repositories.

Screenshot of uninstalled Azure Boards GitHub app.

Try this next

Add or remove GitHub repositories