Proxmox VE Operations

Operates a Proxmox Virtual Environment (PVE) estate: hypervisor lifecycle, golden-image builds, major-version upgrades, and multi-node estate services (PDM, PBS).

Claims in this skill are labeled by provenance: doc-sourced (cited to an official Proxmox source), or session-proven 2026-07-09 (observed live against two production nodes during a same-day 8.x-to-9.2.4 / Debian-13.5 modernization). Neither label is a guarantee against future PVE releases — re-verify against the authoritative docs below before relying on version-specific behavior.

Authoritative docs rule

PVE's API and CLI surface drifts across versions faster than training data tracks. Before implementing anything version-sensitive (parameter names, content types, breaking changes), consult the node-served documentation instead of guessing:

• https://<node>:8006/pve-docs/index.html — version-matched to the exact PVE build running on that node. Always current for that node; never stale.
• https://<node>:8006/pve-docs/api-viewer/apidoc.js — the live API schema for that node's exact version (parameters, methods, return shapes).

Substitute the node's LAN IP or hostname. These pages require the self-signed cert or -k/--insecure when fetched with curl. Prefer them over memory for any claim about parameter availability, content-type gating, or breaking changes between versions — see references/upgrade-8-to-9.md for a documented case (import-from vs import) where getting this wrong breaks the golden-image pipeline.

Two-tier access model

Two access tiers cover every operation. Escalate to the higher tier only when the lower tier cannot perform the operation.