Skip to main content
skill CX Codex

proxmox — Claude Code skill: what it does, how to install

Proxmox VE reference guide for managing VMs and LXC containers, networking, cluster configurations, and backups.

MIT 1 installs ★ 7 updated 2026-01-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add poindexter12/waypoint --skill proxmox -a claude-code
Open on GitHub

What proxmox does

This skill equips your coding agent with operational guidance for Proxmox VE environments. It outlines key CLI commands for qm, pct, pvecm, pvesh, and vzdump, along with pre-flight deployment checklists and container-versus-VM evaluation matrices.

The underlying references cover external provisioning patterns for Terraform and Ansible, cloud-init provisioning, Docker hosting setups, storage backends, and network bridge partitioning. Because this is purely a knowledge skill, executing actions on actual clusters requires your agent to have active CLI or API credentials on the host.

What it helps with

  • look up CLI syntax for managing VMs with qm or LXC containers with pct
  • evaluate whether to choose an LXC container or a VM for a service
  • verify network bridges, VLANs, and node limits before provisioning
  • structure vzdump backup commands and cloud-init templates

Example prompts for the agent

  • Show me how to unlock and gracefully shut down VM 102 via Proxmox CLI
  • Help configure a vzdump command to back up all nodes with zstd compression
  • What bridge and VLAN setup should I use for isolated storage traffic in Proxmox?

How to install proxmox

1Skills CLI (Vercel)

npx skills add poindexter12/waypoint --skill proxmox -a claude-code

2Manually: put the files in place

~/.claude/skills/proxmox/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/proxmox/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about proxmox

How to install proxmox in Claude Code?

Run npx skills add poindexter12/waypoint --skill proxmox -a claude-code in your terminal.

What does the proxmox skill do?

It gives the assistant structured documentation on Proxmox VE management, automation with Ansible or Terraform, network layouts, and error diagnostics.

Does this skill connect directly to my Proxmox cluster?

No, it functions as an operational reference manual. Any cluster interaction relies on the shell access and command privileges available to your agent.

Source text

SKILL.md · MIT
---
name: proxmox
description: |
  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.
agent: proxmox-expert
---

# Proxmox Skill

Proxmox VE virtualization platform reference for VM management, containers, clustering, and homelab infrastructure.

## Quick Reference

```bash
# 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 |

© poindexter12 · MIT · poindexter12/waypoint

Similar skills

All skills for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open