» Accessing Terraform Enterprise

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, or contact HashiCorp sales to purchase a TFE subscription.

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.

» Next Steps

After you've created a TFE organization, you should configure version control access.