State Management

Terraform uses a state file to map your configuration to real-world resources. Understanding state is essential for working with Terraform safely and effectively, especially in team environments.

---

What is State?

The Terraform state file (terraform.tfstate) is a JSON file that records:

• Which resources Terraform manages
• The current attributes of each resource
• The mapping between resource addresses and real-world IDs
• Dependency relationships between resources

Your Configuration (.tf)     State File (.tfstate)     Real Infrastructure
┌──────────────────┐        ┌──────────────────┐       ┌──────────────────┐
│ aws_instance.web │  ←──→  │ id: i-0abc123    │  ←──→ │ EC2 Instance     │
│ type: t3.micro   │        │ type: t3.micro   │       │ i-0abc123        │
└──────────────────┘        └──────────────────┘       └──────────────────┘

---

Why State Matters

Purpose	Description
Mapping	Links resource addresses to real-world resource IDs
Performance	Caches resource attributes to avoid querying every API on every plan
Dependencies	Tracks dependency order for correct creation and destruction
Drift detection	Compares state with real infrastructure to detect out-of-band changes

---

Local State

By default, Terraform stores state locally in terraform.tfstate:

ls -la terraform.tfstate
# -rw-r--r--  1 user  staff  4096 terraform.tfstate