Unsupported Terraform Core version Terraform Origin: Platform & cloud OSI layer 7 · Application Last updated 5 Nov 2026

Terraform: Error: Unsupported Terraform Core version — This configuration does not support Terraform version 1.5.7

The installed Terraform CLI doesn't satisfy required_version in the configuration (or a module).

Exact message you may see Error: Unsupported Terraform Core versionThis configuration does not support Terraform version 1.5.7. To proceed, either choose another supported Terraform version or update this version constraintUnsupported Terraform Core version required_versionError: Unsupported Terraform Core version module requires Terraformdoes not support Terraform version
Explore the map of this error Full error map →
Seen on: Terraform

Meaning

Install a matching version (tfenv install 1.9.5, asdf, or download), or adjust required_version if safe. Modules can also set constraints — the message names the file. Teams should pin one version via .terraform-version/CI.

Common causes

  • CLI older/newer than required_version
  • Module requiring a different version
  • CI image with another Terraform
  • Multiple Terraform binaries on PATH
  • State written by a newer version

⚡ Quick fix

  1. tfenv install && tfenv use per .terraform-version
  2. Update required_version = ">= 1.5, < 2.0" consistently
  3. Align CI and local versions

Detailed fix by platform

Terraform

  1. terraform version && grep -R required_version --include=*.tf .

How to diagnose

  1. Constraint — Where?
  2. CLI — Version?
  3. Pin — tfenv/asdf?

🔧 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):

client version is too new — Error response from daemon: client version 1.45 is too new. Maximum supported API version is 1.41 (Docker)client version is too…Error acquiring the state lock — Terraform: Error: Error acquiring the state lock — ConditionalCheckFailedException / state blob is already locked (Terraform)Error acquiring the s…Error building ARM Config: obtain subscription from Azure CLI — Terraform: Error: building AzureRM Client: obtaining subscription ID / Please run 'az login' to setup account (Terraform)Error building ARM Co…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…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 RegionNo valid credential sources found (AWS provider) — Terraform: Error: No valid credential sources found — failed to refresh cached credentials, no EC2 IMDS role found / Error: configuring Terraform AWS Provider: no valid credential sources (Terraform)No valid credential s…state snapshot was created by a newer Terraform version — Terraform: Error: state snapshot was created by Terraform v1.9.0, which is newer than current v1.6.6; upgrade to Terraform v1.9.0 or greater to work with this state (Terraform)state snapshot was cr…UnauthorizedOperation / AccessDenied during Terraform apply — Terraform: Error: creating EC2 Instance: UnauthorizedOperation: You are not authorized to perform this operation. User: arn:aws:iam::123:user/ci is not authorized to perform: ec2:RunInstances (Terraform)UnauthorizedOperation…Unsupport…

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.