Configure GitHub.com access through OAuth

HCP Terraform is more powerful when you integrate it with your version control system (VCS). There are three different ways to connect GitHub.com to HCP Terraform.

1. Our configuration-free GitHub App — we recommend this method for beginning users on HCP Terraform.
2. Configuring GitHub.com access to HCP Terraform through OAuth connection — use this method to manage your HCP Terraform workspaces via the TFE Provider or HCP Terraform API.
3. Skip the OAuth configuration process and authenticate with a personal access token. This requires using HCP Terraform's API. For details, see the OAuth Clients API page.

In this tutorial, you will set up GitHub.com OAuth access to HCP Terraform by completing the following three steps.

1. On HCP Terraform, add a new VCS Provider
2. On GitHub, create a new OAuth application
3. On HCP Terraform, set up your provider

Prerequisites

For this tutorial, you will need:

1. an HCP Terraform account with permission to manage VCS settings for the organization
2. a GitHub account

On HCP Terraform, add a new VCS Provider

Open HCP Terraform in your browser and navigate to your organization settings. Then, select Version Control | Providers from the left navigation.