How to fix Error: Duplicate required providers configuration - A module may have only one required providers configuration in Terraform

Search your Terraform configuration directory for all occurrences of the required_providers block. This includes main files, versions.tf, providers.tf, and any other .tf files in the module.

# Search for all required_providers blocks
grep -r "required_providers" .

Note the line numbers and files where required_providers appears. You should only have one per module.

If you have required_providers in multiple files, choose one file to be your source of truth (usually versions.tf or main.tf) and move all provider declarations there.

Before (split configuration):

# versions.tf
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

# providers.tf
terraform {
  required_providers {
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 2.0"
    }
  }
}

After (consolidated):

# versions.tf
terraform {
  required_version = ">= 0.13"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 2.0"
    }
  }
}

Then delete the terraform block from the other files.

Delete any remaining terraform blocks containing required_providers from other configuration files. You can keep other terraform block settings like required_version in the main file if needed.

# Example: if you consolidated into versions.tf, remove terraform block from providers.tf
# Edit providers.tf and remove or comment out the terraform block

Modules are allowed to have required_providers blocks that declare their dependencies. However, make sure your root module doesn't duplicate these provider declarations.

Each module should declare its own provider requirements independently. The root module can then satisfy all constraints with a single version of each provider.

# Root module consolidates all requirements
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = ">= 4.0"  # Must satisfy all modules
    }
  }
}

module "networking" {
  source = "./modules/networking"
  # Module has its own required_providers block
}

module "database" {
  source = "./modules/database"
  # Module has its own required_providers block
}

After consolidating your configuration, run terraform init to reinitialize your working directory and verify the error is resolved.

terraform init

If successful, you should see output indicating the Terraform configuration has been initialized without errors. You can then proceed with terraform plan and apply.