Cloud Configuration

The main module of an OpenTofu configuration can integrate with a cloud backend to enable its CLI-driven run workflow (if supported by your cloud backend). You only need to configure these settings when you want to use OpenTofu CLI to interact with a cloud backend. A cloud backend ignores them when interacting with OpenTofu through version control or the API.

Usage Example

To configure the cloud CLI integration, add a nested cloud block within the terraform block. You cannot use the CLI integration and a state backend in the same configuration.

Refer to Using the Cloud Backend in the OpenTofu CLI documentation for full configuration details, migration instructions, and command line arguments.

locals {
	org = "example_corp"
}

terraform {
  cloud {
    organization = local.org
    hostname = "app.example.io"

    workspaces {
      tags = ["app"]
    }
  }
}

:::note Cloud fields may not contain any references to data in the state or provider defined functions. All values must be able to be resolved during tofu init before the state is available. :::