Virtual Event
Join us for the next HashiConf Digital October 12-15, 2020 Register for Free

Get Started - Terraform Cloud

Create a Workspace

In the previous guide, you created an account and an organization on Terraform Cloud.

In this guide, you will create your first version control system (VCS) enabled workspace with GitHub. This will enable you to collaborate with your team on Terraform configurations. You will learn how to create a Terraform Cloud workspace by connecting a VCS repository to Terraform Cloud.

»Fork a Github repository

Visit the Terraform Cloud example repository and click the "Fork" button at the top right of the page to create a fork of the repository into your account.

»Connect to GitHub

If you've just signed up with Terraform Cloud and created a new organization, the first page you'll see is the "New Workspace" page. You can also create a new workspace by choosing "Workspaces" from the main menu, and then the "New Workspace" button.

On the "New Workspace" page, select "GitHub" and then choose "" from the drop-down to continue.

New workspace

A new window will open asking you to authorize Terraform Cloud to use your GitHub account. Click the green "Authorize" button to connect Terraform Cloud to your GitHub account.

GitHub Authorization

You may be asked to install Terraform Cloud for your GitHub account/organization. If prompted, select your account/organization to install Terraform Cloud.

Install Terraform Cloud

For information about installing Terraform Cloud on GitHub, refer to the Terraform Documentation: Configuration-Free GitHub Usage.

»Choose a repository

Next, you will see a list of your GitHub repositories. Choose the repository you forked in the first step. If you have a lot of GitHub repositories, you may need to filter the list to find the correct one.

Choose Repository

»Create the workspace

On the final step, leave the workspace name and "Advanced options" unchanged, and click the purple "Create workspace" button to create the workspace.

Configure settings

It will take a few minutes for Terraform Cloud to connect to your GitHub repository. Once that's complete, you should see a notification that your configuration was uploaded successfully.

Configuration Successful

»Next Steps

In this guide, you created a workspace and connected it to your GitHub repository.

In the next guide, you will set up your new workspace and provision your DynamoDB instance through Terraform Cloud.