Terraform Proxmox Inventory Layer

This directory codifies existing Proxmox infrastructure using an import-first reconciliation model.

Purpose

Track existing Proxmox VMs in Terraform.
Reconcile imported VM configuration into maintainable, explicit files.
Represent physical host metadata as structured Terraform locals/outputs.
Support documentation inventory and future downstream tooling.

Current repository status

This directory already contains imported/reconciled VM resources (for example docker, server-nixos, nix-cache, pbs, pihole) plus host metadata locals/outputs.

This means it is no longer just a scaffold; treat it as active infrastructure inventory code.

Workflow standard (brownfield)

Import one existing VM at a time.
Confirm provider-specific import ID format.
Inspect state/plan details.
Keep hand-maintained .tf files focused and readable.
Use ignore_changes only where drift noise is unavoidable.
Stop when plan is sane/no-op for intended scope.

File organization expectations

Prefer one-resource-per-file patterns when practical.
Keep shared metadata in locals/outputs with clear descriptions.
Keep generated comments/config under ongoing cleanup rather than assuming generated output is final.

Safety notes

Do not run broad applies casually.
Do not commit real credentials or .tfstate*.
Keep changes incremental and reviewable.

1.7 KiB Raw Blame History