SkillsAdd

smithery.ai

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.

First seen Mar 10, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

proxmox-admin Similar name
bastos/skills

Administers Proxmox VE hosts, creates and manages VMs with qm, manages LXC containers with pct,…

690 installs
proxmox-mcp-tools Similar name
bldg-7/proxmox-mcp

Comprehensive MCP tool reference for Proxmox Virtual Environment management - 92 tools across 1…

110 installs
proxmox-infrastructure Similar name
basher83/lunar-claude

Manage the Matrix/Virgo-Core Proxmox VE cluster (nodes Foxtrot, Golf, Hotel - MINISFORUM MS-A2 …

102 installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,715 B
  • docs SUMMARY.md 382 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 10 installs

SKILL.md

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](references/vm-lxc.md) Choosing virtualization type
Docker Hosting [docker-hosting.md](references/docker-hosting.md) Running Docker on Proxmox
Networking [networking.md](references/networking.md) Bridges, VLANs, SDN, firewall
Storage [storage.md](references/storage.md) Storage backends, content types
Cloud-init [cloud-init-templates.md](references/cloud-init-templates.md) VM provisioning with cloud-init
Clustering [clustering.md](references/clustering.md) HA, quorum, fencing
Backup [backup.md](references/backup.md) vzdump modes, restore
CLI Tools [cli-tools.md](references/cli-tools.md) qm, pct, pvecm, pvesh commands
Troubleshooting [troubleshooting.md](references/troubleshooting.md) Common errors, diagnostics
Automation Tools [automation-tools.md](references/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