Inputs

Inputs

You can set values for your module’s input parameters by specifying an inputs block in terragrunt.hcl:

inputs = {
  instance_type  = "t2.micro"
  instance_count = 10

  tags = {
    Name = "example-app"
  }
}

Whenever you run a Terragrunt command, Terragrunt will set any inputs you pass in as environment variables. For example, with the terragrunt.hcl file above, running terragrunt apply is roughly equivalent to:

$ terragrunt apply

# Roughly equivalent to:

TF_VAR_instance_type="t2.micro" \
TF_VAR_instance_count=10 \
TF_VAR_tags='{"Name":"example-app"}' \
tofu apply # or terraform apply

Note that Terragrunt will respect any TF_VAR_xxx variables you’ve manually set in your environment, ensuring that anything in inputs will NOT override anything you’ve already set in your environment.

Variable precedence

Terragrunt follows the same variable precedence as tofu.

If the same variable is assigned multiple values, OpenTofu will use the last value it finds overriding any previous values.

Variables are loaded in the following order:

• Environment variables.

• terraform.tfvars file, if present.

• terraform.tfvars.json file, if present.

• Any *.auto.tfvars/*.auto.tfvars.json files, processed in order of their filenames.

• Any -var/-var-file options on the command line, in the order they are provided.