winget install --id Gruntwork.TerragruntAbout Terragrunt
Terragrunt is a thin wrapper for Terraform that provides extra tools for keeping your Terraform configurations DRY, working with multiple Terraform modules, and managing remote state.
What's new in 1.0.5
✨ New Features Full .terraform.lock.hcl files from the provider cache server When the provider cache server is used against the OpenTofu provider registry, Terragrunt now writes .terraform.lock.hcl files containing h1: hashes for every platform the registry supports. A single terragrunt init produces a lock file that works on every platform, removing the need to run tofu providers lock -platform=... separately for each target architecture. provider "registry.opentofu.org/hashicorp/null" { version = "3.2.2" constraints = "3.2.2" hashes = [ "h1:+1mRmfyz6oA00IhrrSkHK3h/Mdh032x2p0F6OMdMo5s=", "h1:FjLTqvaaYo+vHN8pHZB1cOwEGiNzOj+I9kQyHmr9/7o=", # ... one entry per supported platform ... "zh:00e5877d19fb1c1d8c4b3536334a46a5c86f57146fd115c7b7b4b5d2bf2de86d", # ... one entry per supported platform ... ] } The hashes come from the registry's per-platform download response. When the registry does not supply them (for example, a third-party registry that has not adopted the field), Terragrunt falls back to its previous behavior of writing an h1: hash for the current platform plus zh: hashes for every platform listed in the shasums document. Tip Thanks to the OpenTofu team This feature builds on work done by the OpenTofu team to expose per-platform hashes directly from the OpenTofu provider registry. Starting with OpenTofu 1.12, tofu init populates .terraform.lock.hcl with hashes for every supported platform out of the box, with no tofu providers lock invocation required. Users on older OpenTofu versions still get the same lock files when running through Terragrunt's provider cache serv...
Version history
| Version | Updated | Notes |
|---|---|---|
| 1.0.5 | Unknown | ✨ New Features Full .terraform.lock.hcl files from the provider cache server When the provider cache server is used against the OpenTofu provider registry, Terragrunt now writes .terraform.lock.hcl files containing h1: h... |
| 1.0.3 | Unknown | ✨ New Features --no-cas flag for disabling CAS per command The new --no-cas flag disables the CAS for a single invocation, even when the cas experiment is enabled. It is available on run, stack generate, and stack run. t... |
| 1.0.2 | Unknown | 🐛 Bug Fixes shared_credentials_files and other list/map backend config values were serialized incorrectly Setting shared_credentials_files (or any other list-valued key) in the remote_state.config block produced a broken... |
| 1.0.1 | Unknown | 🧪 Experiments Added dag-queue-display — DAG tree visualization for the run queue A new dag-queue-display experiment renders the run queue as a dependency tree instead of a flat list, making it easier to understand execut... |
| 1.0.0 | Unknown | 🎉 v1.0.0 Release Terragrunt is now v1! This means that Terragrunt will no longer have any breaking changes in minor releases, with all future breaking changes taking place in (infrequent) future major releases. For a lis... |
| 0.99.5 | Unknown | 🐛 Bug Fixes --working-dir interaction with exit codes fixed A bug in the logic for tracking exit codes for plan -detailed-exitcode when users supply the --working-dir flag has been fixed. Authentication during queue cons... |
| 0.99.4 | Unknown | 🏎️ Performance Improvements Discovery performance improved The way in which Terragrunt discovers and filters units and stacks for runs has improved significantly. Screenshot 2026-02-17 at 17 43 55 Screenshot 2026-02-17 a... |
| 0.99.3 | Unknown | 🐛 Bug Fixes Over-warning on strict controls prevented Using --strict-mode resulted in over-warning on completed controls. Those warnings will no longer appear when using strict mode. What's Changed - chore: Backport #550... |
| 0.99.2 | Unknown | 🐛 Bug Fixes Interrupt signal propagation to OpenTofu/Terraform fixed The mechanism by which Terragrunt sends interrupt signals to OpenTofu/Terraform processes it started has been made more robust. Terragrunt will now sen... |
| 0.99.1 | Unknown | 🐛 Bug Fixes Pass through null inputs Fixes a bug where null inputs weren't being passed through correctly to OpenTofu/Terraform. What's Changed - fix: Backport null input passing fix by @yhakbar in #5458 Full Changelog:... |
| 0.99.0 | Unknown | 🛠️ Breaking Changes Undocumented behavior removed We have removed several undocumented features that served as temporary stop-gaps to facilitate experimentation. The following environment variables no longer affect Terra... |
| 0.98.0 | Unknown | ✨ New Features The --filter flag now implies --all When using the --filter flag, it is now optional to also supply --all. Terragrunt will automatically set the --all flag when you use the --filter flag. 🐛 Bug Fixes Plan... |
| 0.97.2 | Unknown | 🏎️ Performance Improvements Partial parse used for get_working_dir() To assess where Terragrunt is going to run OpenTofu, it needs partially parsed information from the relevant terragrunt.hcl file of the unit running th... |
| 0.97.1 | Unknown | ✨ New Features All HCL functions instrumented with OpenTelemetry All Terragrunt HCL functions are now instrumented to emit telemetry when they run, giving more insight into HCL function performance, and usage. HCL parsin... |
| 0.97.0 | Unknown | ⚒️ Breaking Changes The --queue-strict-include flag is deprecated Terragrunt no longer automatically includes dependencies of included units. As such the --queue-strict-include flag is no longer useful in the Terragrunt... |
| 0.96.1 | Unknown | 🧪 Experiments Updated The --filter-affected flag has more robust determination of the default branch in a Git repository The --filter-affected flag will now use Git plumbing to interrogate the default branch as considere... |
| 0.96.0 | Unknown | 🛠️ Breaking Changes The --no-destroy-dependencies-check flag has been deprecated The default behavior of Terragrunt with respect to checking dependents during destroys has been inverted. As a consequence the --no-destroy... |
| 0.95.1 | Unknown | 🧪 Experiments Updated The filter-flag experiment now supports the --filter-affected flag The --filter-affected flag has been introduced as an convenience alias for --filter [main...HEAD] (remember that you must use the f... |
| 0.95.0 | Unknown | 🛠️ Breaking Changes The --queue-exclude-external flag has been deprecated Previously, Terragrunt would automatically pull in external dependencies (dependencies outside the current working directory when running terragru... |
| 0.94.0 | Unknown | ✨ Features - Terraform 1.14: We are now testing Terragrunt against Terraform 1.14 and is confirmed to be working. NOTE: Although this release is marked as backward incompatible, it is functionally compatible as nothing h... |