docs/src/content/docs/04-reference/05-supported-versions.mdx
import CompatibilityTable from '@components/CompatibilityTable.astro';
The officially supported versions are:
<CompatibilityTable tool="opentofu" />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.
Version compatibility data is available via JSON API:
| Endpoint | Description |
|---|---|
/api/v1/compatibility | All entries |
/api/v1/compatibility/opentofu | OpenTofu only |
/api/v1/compatibility/terraform | Terraform only |
Example:
curl https://docs.terragrunt.com/api/v1/compatibility/opentofu
Response format:
[
{
"tool": "opentofu",
"version": "1.11.x",
"terragrunt_min": "0.95.0",
"terragrunt_max": null
}
]
| Field | Description |
|---|---|
tool | IaC tool name: opentofu or terraform |
version | Tool version pattern (e.g., 1.11.x) |
terragrunt_min | Minimum compatible Terragrunt version |
terragrunt_max | Maximum compatible version, or null for open-ended support |