Back to Terragrunt

OpenTofu and Terraform Version Compatibility Table

docs/src/content/docs/04-reference/05-supported-versions.mdx

1.0.32.2 KB
Original Source

import CompatibilityTable from '@components/CompatibilityTable.astro';

Supported OpenTofu Versions

The officially supported versions are:

<CompatibilityTable tool="opentofu" />

Supported Terraform Versions

The officially supported versions are:

<CompatibilityTable tool="terraform" />

Note 1: Terragrunt lists support for BSL versions of Terraform (>= 1.6.x) and core IaC functionality will work as expected. However, support for BSL Terraform-specific features is not guaranteed even if that version is in this table.

Note 2: This table lists versions that are officially tested in the CI process. In practice, the version compatibility is more relaxed than documented above. For example, we've found that Terraform 0.13 works with any version above 0.19.0, and we've also found that terraform 0.11 works with any version above 0.19.18 as well.

If you wish to use Terragrunt against an untested Terraform version, you can use the terraform_version_constraint (introduced in Terragrunt v0.19.18) attribute to relax the version constraint.

Compatibility API

Version compatibility data is available via JSON API:

EndpointDescription
/api/v1/compatibilityAll entries
/api/v1/compatibility/opentofuOpenTofu only
/api/v1/compatibility/terraformTerraform only

Example:

bash
curl https://docs.terragrunt.com/api/v1/compatibility/opentofu

Response format:

json
[
  {
    "tool": "opentofu",
    "version": "1.11.x",
    "terragrunt_min": "0.95.0",
    "terragrunt_max": null
  }
]
FieldDescription
toolIaC tool name: opentofu or terraform
versionTool version pattern (e.g., 1.11.x)
terragrunt_minMinimum compatible Terragrunt version
terragrunt_maxMaximum compatible version, or null for open-ended support