Terraform Enterprise

Intro to Terraform Enterprise

Welcome to Terraform Enterprise!

Terraform Enterprise helps teams collaborate on infrastructure. It combines a predictable and reliable shared run environment with tools to help you work together on Terraform configurations and modules. To learn more about its features and functionality, and to request a free trial, see the Terraform Enterprise product page.

» Prerequisites

To start using Terraform Enterprise (TFE), you must:

  • Make sure you have a TFE account.
  • Contact HashiCorp sales to request access to TFE.
  • Navigate to TFE.
  • Create a new organization for working with TFE.

» Creating a TFE Account

If you don't already have a TFE account, you must create one. You can use the same user account to access the new TFE and the previous legacy version of TFE, although you'll use separate organizations.

Click here to request a free trial of TFE.

In your web browser, go to:

  • app.terraform.io if you've registered for the SaaS version of TFE.
  • The hostname of your private instance if you're using private Terraform Enterprise.

» Creating an Organization

After you've navigated to TFE, it will prompt you to create a new organization. Enter a name (distinct from your legacy TFE organization, if any) and an admin email address at the prompt:

TFE's new organization prompt

» Adding Other Users to an Organization

To collaborate with your colleagues in TFE, you'll all need access to the same TFE organization. You can add users to an organization by creating a team and adding users to it.

First, navigate to the settings page for your organization — you can reach it from the "Settings" link found at the top of every page. Once there, click the "Teams" link in the sidebar navigation.

The list of teams starts with just one team, named "owners." Don't add users to this team yet; instead, enter a new team name (like "core-infrastructure") in the text field and click the "Create team" button. This will take you to the new team's settings page:

adding members to a team

Add as many users as you'd like by typing their TFE username in the text field and clicking "Add member". Added users won't receive a notification, but your organization will be available the next time they access TFE.

Team membership is how TFE controls access to workspaces. Later, you can create more teams and assign them different permissions on a per-workspace basis. For more information, see Teams.