Auto-Retry is a feature of terragrunt that will automatically address situations where a terraform command needs to be re-run.

Terraform can fail with transient errors which can be addressed by simply retrying the command again. In the event terragrunt finds one of these errors, the command will be re-run again automatically.


$ terragrunt apply
Initializing provider plugins...
- Checking for available provider plugins on
Error installing provider "template": error fetching checksums: Get net/http: TLS handshake timeout.

Terragrunt sees this error, and knows it is a transient error that can be addressed by re-running the apply command.

auto-retry will try a maximum of three times to re-run the command, at which point it will deem the error as not transient, and accept the terraform failure. Retries will occur when the error is encountered, pausing for 5 seconds between retries.

Terragrunt has a small list of default known errors built-in. You can override these defaults with your own custom retryable errors in your terragrunt.hcl configuration:

retryable_errors = [
  "a regex to match the error",
  "another regex"


retryable_errors = [
  "(?s).*Error installing provider.*tcp.*connection reset by peer.*",
  "(?s).*ssh_exchange_identification.*Connection closed by remote host.*"

Future upgrades to terragrunt may include the ability to configure max retries and retry intervals in the terragrunt config (PRs welcome!).

To disable auto-retry, use the --terragrunt-no-auto-retry command line option or set the TERRAGRUNT_AUTO_RETRY environment variable to false.