TerraformOpenTofu and Terragrunt Compatibility Chart

Ensuring your Terragrunt version aligns with your Terraform or OpenTofu release is critical for a seamless infrastructure automation workflow. Terragrunt is rigorously tested against specific Terraform/OpenTofu versions, and mismatches can lead to plan/apply errors or unexpected behavior.

Why Version Compatibility Matters

Prevents runtime errors during terragrunt plan or terragrunt apply
Ensures access to the latest features without sacrificing stability
Simplifies troubleshooting by minimizing version-related issues

Note

Always review the Terragrunt release notes before upgrading. Breaking changes can impact your existing configuration.

Compatibility Chart

Refer to the matrix below to confirm which Terragrunt versions support your Terraform or OpenTofu release:

The image is a compatibility chart showing the versions of Terraform/OpenTofu and their corresponding compatible Terragrunt versions. It includes a link to more information on supported versions.

Best Practices for Managing Versions

Action	Example
Pin Terraform/OpenTofu in modules	`hcl<br>terraform {<br> required_version = ">= 1.5.0, < 1.6.0"<br>}<br>`
Lock Terragrunt in CI/CD	`yaml<br>steps:<br>- uses: gruntwork-io/[email protected]<br>`
Regularly audit version constraints	Run `terragrunt validate-all` after upgrades to catch incompatibilities

Links and References

Watch Video

Watch video content