mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-02-21 11:01:23 -05:00
37 lines
1.6 KiB
Plaintext
37 lines
1.6 KiB
Plaintext
---
|
|
page_title: Terraform Cloud Configuration - Terraform Settings - Configuration Language
|
|
description: >-
|
|
The nested `cloud` block configures Terraform's integration with Terraform
|
|
Cloud.
|
|
---
|
|
|
|
# Terraform Cloud Configuration
|
|
|
|
The main module of a Terraform configuration can integrate with Terraform Cloud to enable its
|
|
[CLI-driven run workflow](/cloud-docs/run/cli). You only need to configure these settings when you want to use Terraform CLI to interact with Terraform Cloud. Terraform Cloud ignores them when interacting with
|
|
Terraform through version control or the API.
|
|
|
|
> **Hands On:** Try the [Migrate State to Terraform Cloud](https://learn.hashicorp.com/tutorials/terraform/cloud-migrate) tutorial on HashiCorp Learn.
|
|
|
|
You can configure the Terraform Cloud CLI integration by adding a nested `cloud` block within the top-level
|
|
`terraform` block:
|
|
|
|
```hcl
|
|
terraform {
|
|
cloud {
|
|
organization = "example_corp"
|
|
hostname = "app.terraform.io" # Optional; defaults to app.terraform.io
|
|
|
|
workspaces {
|
|
tags = ["app"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
If you do not specify the `hostname`, it defaults to `app.terraform.io` for Terraform Cloud. For Terraform Enterprise installations, include the `hostname` configuration argument.
|
|
|
|
You cannot use the CLI integration and a [state backend](/language/settings/backends) in the same configuration; they are mutually exclusive. A configuration can only provide one `cloud` block and the `cloud` block cannot refer to named values like input variables, locals, or data source attributes.
|
|
|
|
Refer to [Using Terraform Cloud](/cli/cloud) in the Terraform CLI docs for more information.
|