github.com/loicalbertin/terraform@v0.6.15-0.20170626182346-8e2583055467/website/docs/backends/types/terraform-enterprise.html.md (about) 1 --- 2 layout: "backend-types" 3 page_title: "Backend Type: terraform enterprise" 4 sidebar_current: "docs-backends-types-standard-terraform-enterprise" 5 description: |- 6 Terraform can store the state in Terraform Enterprise 7 --- 8 9 # terraform enterprise 10 11 **Kind: Standard (with no locking)** 12 13 Stores the state in [Terraform Enterprise](https://www.terraform.io/docs/providers/index.html). 14 15 You can create a new environment in the 16 Environments section and generate new token in the Tokens page under Settings. 17 18 ~> **Why is this called "atlas"?** Atlas was previously a commercial offering 19 from HashiCorp that included a full suite of enterprise products. The products 20 have since been broken apart into their individual products, like **Terraform 21 Enterprise**. While this transition is in progress, you may see references to 22 "atlas" in the documentation. We apologize for the inconvenience. 23 24 ## Example Configuration 25 26 ```hcl 27 terraform { 28 backend "atlas" { 29 name = "bigbang/example" 30 access_token = "foo" 31 } 32 } 33 ``` 34 35 Note that for the access token we recommend using a 36 [partial configuration](/docs/backends/config.html). 37 38 ## Example Referencing 39 40 ```hcl 41 data "terraform_remote_state" "foo" { 42 backend = "atlas" 43 config { 44 name = "bigbang/example" 45 access_token = "X2iTFefU5aWOjg.atlasv1.YaDa" 46 } 47 } 48 ``` 49 50 ## Configuration variables 51 52 The following configuration options / environment variables are supported: 53 54 * `name` - (Required) Full name of the environment (`<username>/<name>`) 55 * `access_token` / `ATLAS_TOKEN` - (Required) Terraform Enterprise API token 56 * `address` - (Optional) Address to alternative Terraform Enterprise location (Terraform Enterprise endpoint)