Proxmox Skill
Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure.
Quick Reference
# VM management (qm)
qm list # List all VMs
qm status <vmid> # Check VM status
qm start <vmid> # Start VM
qm stop <vmid> # Stop VM (graceful)
qm shutdown <vmid> # Shutdown VM (ACPI)
qm unlock <vmid> # Remove lock
qm config <vmid> # Show VM config
# Container management (pct)
pct list # List all containers
pct status <ctid> # Check container status
pct start <ctid> # Start container
pct stop <ctid> # Stop container
pct enter <ctid> # Enter container shell
# Cluster management (pvecm)
pvecm status # Cluster status and quorum
pvecm nodes # List cluster nodes
# API shell (pvesh)
pvesh get /nodes # List nodes via API
pvesh get /nodes/<node>/status # Node resource status
# Backup (vzdump)
vzdump <vmid> --mode snapshot --storage <storage>
vzdump --all --compress zstd
Reference Files
Load on-demand based on task:
| Topic |
File |
When to Load |
| VM vs LXC |
vm-lxc.md |
Choosing virtualization type |
| Docker Hosting |
docker-hosting.md |
Running Docker on Proxmox |
| Networking |
networking.md |
Bridges, VLANs, SDN, firewall |
| Storage |
storage.md |
Storage backends, content types |
| Cloud-init |
cloud-init-templates.md |
VM provisioning with cloud-init |
| Clustering |
clustering.md |
HA, quorum, fencing |
| Backup |
backup.md |
vzdump modes, restore |
| CLI Tools |
cli-tools.md |
qm, pct, pvecm, pvesh commands |
| Troubleshooting |
troubleshooting.md |
Common errors, diagnostics |
| Automation Tools |
automation-tools.md |
Terraform/Ansible integration |
Validation Checklist
Before deploying VMs/containers:
VM vs LXC Quick Decision
| Factor |
Use VM |
Use LXC |
| OS |
Windows, BSD, any |
Linux only |
| Isolation |
Full kernel isolation |
Shared kernel |
| Performance |
Good |
Better (lighter) |
| Startup |
Slower |
Fast |
| Density |
Lower |
Higher |
| Complexity |
Any workload |
Simple services |
Homelab Network VLANs
| VLAN |
Purpose |
Proxmox Bridge |
| 5 |
Management (Web UI, API, SSH) |
vmbr5 |
| 1 |
Trusted network |
vmbr0 |
| 11 |
Storage (NFS/Ceph, MTU 9000) |
vmbr11 |
| 12 |
High-speed transfers |
vmbr12 |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: poindexter12-waypoint-proxmox3description: Proxmox Skill4---56# Proxmox Skill78Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure.910## Quick Reference1112```bash13# VM management (qm)14qm list # List all VMs15qm status <vmid> # Check VM status16qm start <vmid> # Start VM17qm stop <vmid> # Stop VM (graceful)18qm shutdown <vmid> # Shutdown VM (ACPI)19qm unlock <vmid> # Remove lock20qm config <vmid> # Show VM config2122# Container management (pct)23pct list # List all containers24pct status <ctid> # Check container status25pct start <ctid> # Start container26pct stop <ctid> # Stop container27pct enter <ctid> # Enter container shell2829# Cluster management (pvecm)30pvecm status # Cluster status and quorum31pvecm nodes # List cluster nodes3233# API shell (pvesh)34pvesh get /nodes # List nodes via API35pvesh get /nodes/<node>/status # Node resource status3637# Backup (vzdump)38vzdump <vmid> --mode snapshot --storage <storage>39vzdump --all --compress zstd40```4142## Reference Files4344Load on-demand based on task:4546| Topic | File | When to Load |47|-------|------|--------------|48| VM vs LXC | [vm-lxc.md](references/vm-lxc.md) | Choosing virtualization type |49| Docker Hosting | [docker-hosting.md](references/docker-hosting.md) | Running Docker on Proxmox |50| Networking | [networking.md](references/networking.md) | Bridges, VLANs, SDN, firewall |51| Storage | [storage.md](references/storage.md) | Storage backends, content types |52| Cloud-init | [cloud-init-templates.md](references/cloud-init-templates.md) | VM provisioning with cloud-init |53| Clustering | [clustering.md](references/clustering.md) | HA, quorum, fencing |54| Backup | [backup.md](references/backup.md) | vzdump modes, restore |55| CLI Tools | [cli-tools.md](references/cli-tools.md) | qm, pct, pvecm, pvesh commands |56| Troubleshooting | [troubleshooting.md](references/troubleshooting.md) | Common errors, diagnostics |57| Automation Tools | [automation-tools.md](references/automation-tools.md) | Terraform/Ansible integration |5859## Validation Checklist6061Before deploying VMs/containers:6263- [ ] Cluster status healthy (`pvecm status`)64- [ ] Node resources available (CPU, RAM, disk)65- [ ] Storage accessible and mounted66- [ ] Network bridges configured correctly67- [ ] VLAN tags match network design68- [ ] Resource allocation within node limits69- [ ] HA configuration correct (if enabled)70- [ ] Backup schedule in place71- [ ] Naming convention followed7273## VM vs LXC Quick Decision7475| Factor | Use VM | Use LXC |76|--------|--------|---------|77| OS | Windows, BSD, any | Linux only |78| Isolation | Full kernel isolation | Shared kernel |79| Performance | Good | Better (lighter) |80| Startup | Slower | Fast |81| Density | Lower | Higher |82| Complexity | Any workload | Simple services |8384## Homelab Network VLANs8586| VLAN | Purpose | Proxmox Bridge |87|------|---------|----------------|88| 5 | Management (Web UI, API, SSH) | vmbr5 |89| 1 | Trusted network | vmbr0 |90| 11 | Storage (NFS/Ceph, MTU 9000) | vmbr11 |91| 12 | High-speed transfers | vmbr12 |9293---94> Converted and distributed by [TomeVault](https://tomevault.io/claim/poindexter12) — claim your Tome and manage your conversions.95<!-- tomevault:4.0:skill_md:2026-04-13 -->