Is there support for clustering and high availability?

Yes, it provides status checks for pvecm, quorum management, and guidance on node fencing for multi-node cluster environments.

What networking configurations are covered?

The skill guides you through Linux bridge setup, VLAN tagging for specific homelab or production segments, and firewall management.

How does this skill help with VM management?

It provides immediate access to qm commands for starting, stopping, configuring, and unlocking virtual machines directly within your workflow.

Can I use this for Terraform or Ansible automation?

Yes, the skill includes specific integration patterns and reference files for automating Proxmox resources using popular IaC tools.

Does it support LXC container configuration?

Absolutely, it includes a full reference for pct commands, container shell entry, and resource status checks.

The Proxmox skill equips Claude with specialized knowledge for managing Proxmox Virtual Environment (VE) infrastructures, from individual homelab setups to enterprise-grade clusters. It provides comprehensive reference material for VM and container lifecycle management, network bridging, storage backends, and high-availability configurations. By leveraging native CLI tools like qm, pct, and pvecm, alongside Infrastructure as Code (IaC) patterns for Terraform and Ansible, this skill streamlines virtualization tasks, troubleshooting, and resource planning to ensure high performance and reliability.

주요 기능

01Infrastructure as Code patterns for Terraform and Ansible integration

02Standardized backup and restoration procedures using vzdump

03Cluster health monitoring and high-availability configuration guidance

040 GitHub stars

05Comprehensive VM and LXC lifecycle management commands (qm, pct)

06Advanced networking reference for bridges, VLANs, and SDN setups

사용 사례

01Troubleshooting cluster quorum issues or node resource bottlenecks

02Implementing automated infrastructure workflows using DevOps tools

03Provisioning and configuring Linux containers or Windows VMs with cloud-init

name	description
proxmox	Proxmox VE virtualization platform reference for VM/LXC management, clustering, storage, and networking. Includes Terraform and Ansible integration patterns. Use when working with Proxmox configurations, CLI commands, troubleshooting VMs/containers, or planning resource allocation. Triggers: proxmox, qemu, kvm, lxc, pve, vm, container, cluster, vzdump, qm, pct.

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:

Cluster status healthy (pvecm status)
Node resources available (CPU, RAM, disk)
Storage accessible and mounted
Network bridges configured correctly
VLAN tags match network design
Resource allocation within node limits
HA configuration correct (if enabled)
Backup schedule in place
Naming convention followed

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

Proxmox Virtualization Manager