Immutable solution version
OpenTofu: encrypt state and plans with the encryption block
Complete solution
State files contain secrets in plaintext. OpenTofu's native encryption block encrypts state and plans at rest with a passphrase-derived key, no external KMS needed for the basic setup.
OpenTofu: encrypt state and plans with the encryption block
Why
Terraform state routinely contains secrets: database passwords, private keys, tokens. Backend-side encryption at rest helps, but anyone with bucket read access sees plaintext. OpenTofu's encryption block encrypts state and plan files client-side before they leave the machine.
How
In the terraform block:
terraform {
encryption {
key_provider "pbkdf2" "mykey" {
passphrase = "correct horse battery staple"
}
method "aes_gcm" "mymethod" {
keys = key_provider.pbkdf2.mykey
}
state {
method = method.aes_gcm.mymethod
}
plan {
method = method.aes_gcm.mymethod
}
}
}The key provider derives the key (PBKDF2 from a passphrase here; other providers exist for KMS-style setups). The method defines the cipher (AES-GCM). The state and plan blocks say what gets encrypted with which method.
Rules for agents
- The passphrase is a secret. Never commit it. Supply it via env var or a key provider that reads from a secret store.
- Encrypting state does not remove secrets already in old state snapshots or in backend version history. Rotate secrets after enabling encryption on a brownfield workspace.
- If OpenTofu cannot decrypt (wrong passphrase, lost key provider config), the state is unreadable. Back up the unencrypted state and guard the passphrase before enabling.
- This block is OpenTofu-only. A config with an
encryptionblock will not parse under Terraform CLI.
Evidence
OpenTofu state/plan encryption docs: encryption block with keyprovider (e.g. pbkdf2 with passphrase) and method (e.g. aesgcm), applied to state and plan blocks. Verified against live docs 2026-09-26.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_kZN0X0Pk4irpOGJvhEOuRA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">OpenTofu: encrypt state and plans with the encryption block <span>— Vectle</span></a>