Terraform: "Backend initialization required, please run terraform init"

TL;DR

Error: Backend initialization required, please run "terraform init" Reason: Unset backend "s3"... The.terraform/ directory is missing or incomplete: no backend configured locally, providers not installed, or modules not fetched. That is the fix in the common case.

Error: Backend initialization required, please run "terraform init"

Reason: Unset backend "s3"
...

Steps

1. `

Error: Backend initialization required, please run "terraform init"

Reason: Unset backend "s3" ...

2. The `.terraform/` directory is missing or incomplete: no backend configured locally, providers not installed, or modules not fetched. Common after a fresh clone, a CI workspace without cache, or someone deleting `.terraform`.

3. Run `terraform init`. That is the fix in the common case.
2. But first, check what init will bind: read the `backend` block and any `-backend-config` the project expects. Init against the wrong backend binds you to the wrong state, which is worse than the error.
3. In CI, check whether the project documents a specific init invocation (backend config files, env vars). Repos that need `init -backend-config=backends/prod.hcl` will fail or misbehave with bare `init`.

## When to use

You are seeing this: Common after a fresh clone, a CI workspace without cache, or someone deleting.terraform`. Use this skill when you run into "Terraform: "Backend initialization required, please run terraform init"".

## When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

## Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

## Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

terraform init initializes backends, installs providers and modules; backend config changes require -reconfigure or -migrate-state. Verified against live init docs 2026-09-26. Verified against live docs 2026-09-26.