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.
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.
» Navigating to 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
Note: If someone else has already created a TFE organization and added you to it, you can skip this process. You'll be taken to the organization's front page when you first navigate to TFE.
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:
» 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:
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.
This content originally appeared on the Terraform website documentation.