Failed to install provider (download failed) Terraform Origin: Platform & cloud OSI layer 7 · Application Last updated 5 Nov 2026

Terraform: Error: Failed to install provider — Error while installing hashicorp/aws v5.40.0: could not query provider registry / Get "https://releases.hashicorp.com/...": dial tcp: i/o timeout

Terraform found the provider version but couldn't download/verify the package.

Exact message you may see Error: Failed to install providerError while installing hashicorp/aws v5.40.0: could not query provider registryGet "https://releases.hashicorp.com/terraform-provider-aws": dial tcp: i/o timeoutthe current package for registry.terraform.io/hashicorp/aws doesn't match any of the checksumsError: Failed to install provider from shared cache
Explore the map of this error Full error map →
Seen on: Terraform

Meaning

Check network/proxy (HTTPS_PROXY), TLS interception (custom CA via SSL_CERT_FILE), disk space in .terraform/, and checksum/signature problems. Behind firewalls use a mirror (TF_CLI_CONFIG_FILE with provider_installation { network_mirror } or filesystem mirror) or plugin cache (TF_PLUGIN_CACHE_DIR).

Common causes

  • Proxy/firewall blocking releases.hashicorp.com
  • TLS inspection without trusted CA
  • Disk full/permissions on .terraform
  • Corrupted download/checksum mismatch
  • Air-gapped environment

⚡ Quick fix

  1. Set proxy/CA env vars
  2. Use a mirror or terraform providers mirror offline
  3. Clear .terraform and retry terraform init

Detailed fix by platform

Linux

  1. curl -I https://releases.hashicorp.com && rm -rf .terraform && terraform init

How to diagnose

  1. Network — Reachable?
  2. Proxy/CA — Set?
  3. Disk — Space?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Platform & cloud. Errors that are often confused with or caused by this one (click to open):

Backend initialization required — Terraform: Error: Backend initialization required, please run "terraform init" — Reason: Initial configuration of the requested backend "s3" (Terraform)Backend initializatio…Client.Timeout exceeded — Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded) (Docker)Client.Timeout exceed…Failed to query available provider packages — Terraform: Error: Failed to query available provider packages — Could not retrieve the list of available versions for provider hashicorp/aws: no available releases match the given constraints (Terraform)Failed to query avail…Inconsistent dependency lock file — Terraform: Error: Inconsistent dependency lock file — provider x: required by this configuration but no version is selected (Terraform)Inconsistent dependen…Invalid AWS Region — Terraform: Error: Invalid AWS Region: us-east-3 / Error: configuring Terraform AWS Provider: validating provider credentials: operation error STS: GetCallerIdentity (Terraform)Invalid AWS RegionKubernetes cluster unreachable (provider/helm) — Terraform: Error: Kubernetes cluster unreachable: Get "http://localhost/version": dial tcp 127.0.0.1:80: connect: connection refused (Terraform)Kubernetes cluster un…lookup registry-1.docker.io: no such host — dial tcp: lookup registry-1.docker.io: no such host / Temporary failure in name resolution during docker build (Docker)lookup registry-1.doc…Module not installed — Terraform: Error: Module not installed — This module is not yet installed. Run "terraform init" to install all modules required by this configuration (Terraform)Module not installedFailed to…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.