» 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

TFE cannot currently import settings and workspaces from an existing TFE legacy organization. We will enable migration from TFE legacy at a later date.

» 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 organization dropdown menu 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.

Once the team is created, click its name. This will navigate to the team 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 user." Added users won't receive a notification, but your organization will be available the next time they access TFE.

» Next Steps

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