Proxmox VE Infrastructure Master Class #

Engineering-grade reference manual for Proxmox VE operations across nodes, clusters, storage, networking, virtual machines, containers, snapshots, backups, and read-only health checks.

Overview #

Proxmox VE is a practical virtualization platform for homelabs, edge environments, managed client infrastructure, and private automation clusters. Infrastructure operators need repeatable commands for inventory, health, backup verification, and controlled VM/LXC lifecycle work.

Use these commands for evidence-first operations. Treat power, delete, disk, network, and storage mutations as approval-gated production actions.

Node and Cluster Inventory #

Show Proxmox version:

pveversion

Show cluster status:

pvecm status

List cluster nodes:

pvecm nodes

Show node resource summary:

pvesh get /nodes

Show storage definitions:

pvesm status

Virtual Machine Operations #

List QEMU virtual machines:

qm list

Show VM configuration:

qm config VMID

Show VM runtime status:

qm status VMID

Start a VM after approval:

qm start VMID

Shutdown a VM gracefully after approval:

qm shutdown VMID --timeout 120

Stop a VM only after explicit approval:

qm stop VMID

LXC Container Operations #

List LXC containers:

pct list

Show container configuration:

pct config CTID

Show container status:

pct status CTID

Run a read-only command inside a container:

pct exec CTID -- hostnamectl

Enter a container shell for maintenance:

pct enter CTID

Start a container after approval:

pct start CTID

Shutdown a container after approval:

pct shutdown CTID

Storage and Disk Checks #

List storage pools:

pvesm status

List volumes on a storage target:

pvesm list STORAGE_ID

Show disk inventory:

lsblk

Show ZFS pool status:

zpool status

Show filesystem utilization:

df -h

Networking Checks #

Show Linux bridge and interface configuration:

cat /etc/network/interfaces

Show addresses:

ip addr show

Show routes:

ip route show

Show listening ports:

ss -tulpn

Ping a VM or gateway:

ping -c 4 HOST_OR_IP

Snapshots and Backups #

List VM snapshots:

qm listsnapshot VMID

Create a VM snapshot after approval:

qm snapshot VMID SNAPSHOT_NAME --description "Change window checkpoint"

List container snapshots:

pct listsnapshot CTID

Create a container snapshot after approval:

pct snapshot CTID SNAPSHOT_NAME

List backup jobs:

cat /etc/pve/jobs.cfg

Run a manual backup after approval:

vzdump VMID --storage STORAGE_ID --mode snapshot

Health Evidence Checklist #

• pvecm status shows expected quorum.
• pvesm status shows storage online and available capacity.
• qm list and pct list match expected inventory.
• Critical guests report expected power state.
• Backup jobs exist and recent backup artifacts are present.
• Bridges, routes, and firewall assumptions are documented.