Proxmox VE administration for single-node and clustered environments. Use when Codex needs to operate or troubleshoot Proxmox hosts, VMs, LXCs, storage, networking, backups, replication, HA, migrations, upgrades, or disaster recovery runbooks, including CLI execution plans and risk-aware maintenance procedures.
Plan and execute Proxmox VE operations with a safety-first workflow. Prefer reversible actions, preserve workload availability, and provide explicit pre-checks, change steps, and rollback steps.
references/ based on task type.Run these read-only checks before any change:
# Host and cluster
pveversion -v
hostnamectl
pvecm status
pvecm nodes
# Resource pressure
free -h
df -h
zpool status 2>/dev/null || true
# VM/LXC inventory
qm list
pct list
# Tasks and recent errors
ha-manager status 2>/dev/null || true
systemctl --failed
journalctl -p err -n 100 --no-pager
Load only the relevant reference file for the user request to keep context focused.
When responding, always provide:
For incidents, include immediate containment first, then root-cause investigation.