Skip to main content
Terragrunt is a lightweight wrapper for Terraform, built by Gruntwork to bring structure and automation to Infrastructure as Code (IaC) workflows. Rather than replacing Terraform, Terragrunt enhances it—making it easier to manage complex, multi-environment infrastructures with less repetition and more consistency.
Terragrunt works on top of Terraform. You still write your IaC in Terraform language and benefit from the Terraform CLI.

​
Why Terragrunt?

  • Enforces best practices for Terraform configurations
  • Simplifies remote state configuration and locking
  • Promotes reuse of variables and modules
  • Reduces code duplication with parent–child inheritance

​
Key Features

FeatureDescription
Hierarchical ConfigurationOrganize Terraform code in directories that reflect environments and regions.
Remote State ManagementAutomate backend setup (e.g., S3, Azure Blob, GCS) and enable state locking with DynamoDB or Consul.
Modular Variable DefinitionsDefine shared variables in one place and reference them across multiple modules and environments.
DRY (Don’t Repeat Yourself)Inherit and override configurations in a parent–child folder structure to minimize duplication.
Always enable state locking and encryption for your remote backend to prevent concurrent writes and protect sensitive data.
The image lists four key features: Hierarchical Configuration, Remote Management, Modular Variable Definitions, and DRY Approach, each with an icon.

​
Common Use Cases

Terragrunt shines in scenarios where Terraform alone can become unwieldy:
Use CaseBenefit
Complex Infrastructure ProjectsSimplifies management of interdependent modules, networks, and cloud resources.
Multi-Environment DeploymentsMaintains consistency across dev, staging, and prod through shared remote state and variables.
The image illustrates use cases for Terragrunt, highlighting its application in managing complex infrastructure and deployments.

Watch Video