Terraform Cloud - GitHub App VCS Provider Shows (Installed)

Problem

When you attempt to add a Version Control System (VCS) provider in your HCP Terraform organization's settings, the GitHub App may already show as "Installed". This prevents you from selecting it, as there is no visible option to add it as a VCS provider.

Cause

This issue is caused by a UI display bug that incorrectly marks the GitHub App as installed, even if it has been removed from your GitHub organization or personal account.

Solution

You can work around this UI bug by adding the VCS provider directly from a workspace's settings instead of the organization's settings.

1. Navigate to an existing workspace where you want to connect the VCS provider. If a suitable workspace does not exist, you can create one using a CLI or API-driven workflow.
2. In the workspace, go to Settings > Version Control.
3. Select Connect to a different VCS provider.
4. Choose the GitHub App provider from the list. This should successfully add the provider to your organization.
5. If the first attempt fails, repeat the process. The second attempt typically resolves the connection issue.

Additional Information

This is a known UI display issue and does not affect the functionality of the GitHub App integration once it is connected. For more details on connecting VCS providers, refer to the official HCP Terraform documentation.