honestly its been months, i found unstaged changes and forgot

host_vars/README.md

@@ -5,3 +5,25 @@ Create one file per VM, for example `host_vars/media-01.yml`.
 Use host variables for hostnames, service enablement, storage paths, and port
 assignments. Keep credentials and TLS private material outside Git.
 
+## Proxmox VM Hardware
+
+`scripts/init-proxmox-vms.sh` reads top-level `proxmox_*` keys from each
+`host_vars/*.yml` file. Files without `proxmox_vmid` are skipped.
+
+Example:
+
+```yaml
+proxmox_vmid: 101
+proxmox_name: cloud
+proxmox_template_vmid: 9000
+proxmox_storage: local-lvm
+proxmox_bridge: vmbr0
+proxmox_memory: 4096
+proxmox_cores: 2
+proxmox_cpu: host
+proxmox_disk_size: 64G
+proxmox_backup_enabled: true
+proxmox_ipconfig0: ip=dhcp
+proxmox_onboot: true
+proxmox_start: false
+```