terraform/website/docs/backends/types/terraform-enterprise.html.md

---
layout: "backend-types"
page_title: "Backend Type: terraform enterprise"
sidebar_current: "docs-backends-types-standard-terraform-enterprise"
description: |-
  Terraform can store the state in Terraform Enterprise
---

# terraform enterprise

**Kind: Standard (with no locking)**

Stores the state in [Terraform Enterprise](https://www.terraform.io/docs/providers/index.html).

You can create a new workspace in the
Workspaces section and generate new token in the Tokens page under Settings.

~> **Why is this called "atlas"?** Atlas was previously a commercial offering
from HashiCorp that included a full suite of enterprise products. The products
have since been broken apart into their individual products, like **Terraform
Enterprise**. While this transition is in progress, you may see references to
"atlas" in the documentation. We apologize for the inconvenience.

## Example Configuration

```hcl
terraform {
  backend "atlas" {
    name         = "bigbang/example"
  }
}
```

Note that for the access token we recommend using a
[partial configuration](/docs/backends/config.html).

## Example Referencing

```hcl
data "terraform_remote_state" "foo" {
  backend = "atlas"
  config {
    name         = "bigbang/example"
  }
}
```

## Configuration variables

The following configuration options / environment variables are supported:

 * `name` - (Required) Full name of the environment (`<username>/<name>`)
 * `ATLAS_TOKEN`/ `access_token`  - (Required) Terraform Enterprise API token. It is recommended that `ATLAS_TOKEN` is set as an environment variable rather than using `access_token` in the configuration.
 * `address` - (Optional) Address to alternative Terraform Enterprise location (Terraform Enterprise endpoint)