Remove
An installation keeps its data past a plain tofu destroy: the volumes, the database’s archive
and the logs are in buckets a destroy does not empty, and every bucket refuses object writes and
deletes from outside the VPC - the root account’s included, so they cannot be emptied from a
laptop either. Removing one is said first, applied, and only then destroyed:
-
Set
decommission = trueon the module and apply. Nothing but the buckets changes: their VPC-only policies go, and each is marked to be emptied by a destroy - every version, the GOVERNANCE retention bypassed.Terminal window tofu apply # with decommission = true in module "spin" -
Lift every legal hold. spin holds what each image is rebuilt from, and the provider’s destroy (hashicorp/aws 6.66) lifts a hold and then deletes that version without the bypass, which the retention refuses: the destroy stops on the volumes’ bucket.
Terminal window for b in $(tofu show -json | jq -r '.. | objects | select(.mode? == "managed" and .type? == "aws_s3_bucket" and .values.object_lock_enabled? == true) | .values.bucket'); doaws s3api list-object-versions --bucket $b --output json | jq -r '(.Versions // [])[] | [.Key, .VersionId] | @tsv' |while IFS=$'\t' read -r key id; do aws s3api put-object-legal-hold --bucket $b --key "$key" --version-id "$id" --legal-hold Status=OFF; donedone -
The KMS keys - the encryption key’s, the volumes’ and the identity’s - and the CA refuse to be destroyed, because an apply that replaced one would leave an installation nothing can open. Note the keys, take them out of the state, destroy, and schedule each key’s deletion (the destroy takes their aliases):
Terminal window keys=$(tofu show -json | jq -r '.. | objects | select(.mode? == "managed" and .type? == "aws_kms_key") | .values.key_id')tofu state rm $(tofu state list | grep -E '\.aws_kms_key\.|\.tls_(private_key|self_signed_cert)\.ca$')tofu destroyfor id in $keys; do aws kms schedule-key-deletion --key-id $id --pending-window-in-days 7; done
The apply has to come first: a destroy empties a bucket as its state says, so decommission
set only on the destroy changes nothing - it stops with BucketNotEmpty. A destroy that already
stopped takes the same apply, limited to the buckets and policies the state still has: a bucket
named that the destroy already removed would be made again. Its plan is those buckets’
force_destroy turned on and their policies removed, and nothing else; then step 2 again:
tofu apply $(tofu state list | grep -E '\.aws_s3_bucket(_policy)?\.[a-z]+(\[0\])?$' | sed 's/^/-target=/')# step 2's looptofu destroyWhat is left are the keys, scheduled for deletion in seven days. The state bucket and its key
(bootstrap/) are every installation’s in the account and region, and are removed apart, after
the last of them. .github/workflows/fresh-install.yml in spin-terraform-aws runs all of it every
week - bootstrap, an installation, its first sign-in and this removal - in an account of its own,
and says what that account needs.
Generated by task reference from spin-terraform-aws/README.md at 358445c95.
Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.

