HCP Terraform/Terraform Enterprise: GitHub App already installed or greyed out

Problem

When you attempt to modify or install the GitHub App VCS integration in your organization's settings, the option may appear greyed out and be suffixed with (Installed).

Cause

The GitHub App entry on the organization's VCS settings page is a visual indicator that the integration is available. The GitHub App is marked as installed in all organizations by default because it is a globally-installed integration in HCP Terraform and Terraform Enterprise that you activate on a per-workspace basis.

After you add the GitHub App to your GitHub account, you must manage its repository access permissions directly within GitHub. This can be managed from the user's GitHub application settings or the organization's GitHub application settings (https://github.com/organizations/<organization>/settings/installations).

Solution

Because the GitHub App is enabled per-workspace, you can reauthorize it from the workspace settings if its access has been revoked.

Reauthorizing the GitHub App for a Workspace

1. Navigate to the desired workspace.
2. Go to Settings > Version Control.
3. If a VCS provider is already linked, select Change source. If no provider is linked, select Connect to version control.
4. Choose the Version control workflow.
5. Select Connect to a different VCS to display the provider list.
6. Under the GitHub dropdown, choose GitHub.com (this is the GitHub App) to begin the reauthorization process.

After you reauthorize the app, you can manage its repository access from your GitHub settings again.

Additional Information

For more details on this integration, please refer to the HCP Terraform GitHub App documentation.