Skip to main content
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
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

ActionExample
Pin Terraform/OpenTofu in moduleshcl<br>terraform {<br> required_version = ">= 1.5.0, < 1.6.0"<br>}<br>
Lock Terragrunt in CI/CDyaml<br>steps:<br>- uses: gruntwork-io/[email protected]<br>
Regularly audit version constraintsRun terragrunt validate-all after upgrades to catch incompatibilities

Watch Video