» Terraform Enterprise Provider

The Terraform Enterprise provider is used to interact with the many resources supported by Terraform Enterprise. It supports both the SaaS version of Terraform Enterprise (app.terraform.io) and private instances.

Use the navigation to the left to read about the available resources.

» Authentication

This provider requires a Terraform Enterprise API token in order to manage resources.

To manage the full selection of resources, provide a user token from an account with appropriate permissions. This user should belong to the "owners" team of every Terraform Enterprise organization you wish to manage.

There are three ways to provide the required token:

  • On the CLI, omit the token argument and set a credentials block in your CLI config file.
  • Set the TFE_TOKEN environment variable.
  • In a Terraform Enterprise workspace, set token in the provider configuration. Use an input variable for the token and mark the corresponding variable in the workspace as sensitive.

» Example Usage

# Configure the Terraform Enterprise Provider
provider "tfe" {
  hostname = "${var.hostname}"
  token    = "${var.token}"
}

# Create an organization
resource "tfe_organization" "org" {
  # ...
}

» Argument Reference

The following arguments are supported:

  • hostname - (Optional) The Terraform Enterprise hostname to connect to. Defaults to app.terraform.io. Can be overridden by setting the TFE_HOSTNAME environment variable.
  • token - (Optional) The token used to authenticate with Terraform Enterprise. Only set this argument when running in a Terraform Enterprise workspace; for CLI usage, omit the token from the configuration and set it as credentials in the CLI config file or set the TFE_TOKEN environment variable. See Authentication above for more.