# Error: Failed to download module: checksum mismatch for module source from registry.terraform.io/hashicorp/consul/aws

- **ID:** `terraform/module-source-checksum-mismatch`
- **Domain:** terraform
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 75%

## Root Cause

The downloaded module archive's checksum does not match the expected checksum in the Terraform registry, indicating a corrupted download or tampered module.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Terraform v1.6.0 | active | — | — |
| Terraform v1.7.0 | active | — | — |
| Terraform v1.8.0 | active | — | — |

## Workarounds

1. **Clean the module cache and re-download: 'rm -rf .terraform/modules && terraform init'.** (85% success)
   ```
   Clean the module cache and re-download: 'rm -rf .terraform/modules && terraform init'.
   ```
2. **If the issue persists, specify an exact module version in the source: 'source = "hashicorp/consul/aws" version = "0.11.0"' and run 'terraform init -upgrade'.** (80% success)
   ```
   If the issue persists, specify an exact module version in the source: 'source = "hashicorp/consul/aws" version = "0.11.0"' and run 'terraform init -upgrade'.
   ```
3. **Check network connectivity and proxy settings, then use a different mirror: 'terraform init -plugin-dir=/path/to/mirror'.** (70% success)
   ```
   Check network connectivity and proxy settings, then use a different mirror: 'terraform init -plugin-dir=/path/to/mirror'.
   ```

## Dead Ends

- **** — The corrupted download persists in the .terraform/modules cache. (90% fail)
- **** — The lock file will be regenerated with the same mismatch on next init. (80% fail)
- **** — May introduce breaking changes or other errors. (60% fail)