proxmox_skill

Overview

This skill manages Proxmox VE home lab infrastructure for fast triage and routine operations. It helps discover containers and VMs, inspect resources and logs, and perform common maintenance tasks over SSH. Use it to remotely debug services, manage storage, and verify host health with commands tuned for a home lab setup.

How this skill works

The skill connects to Proxmox hosts via SSH (supports 2FA) and runs Proxmox CLI and host utilities to gather state. It lists containers and VMs, pulls resource usage and network info, reads configs, and streams systemd/journal logs from containers. It also includes targeted commands for storage, ZFS, backups, and common troubleshooting flows.

When to use it

• Triaging a failing container or VM
• Investigating why a self-hosted service is unresponsive
• Checking resource usage or storage health across the cluster
• Listing network listeners and container IPs
• Verifying scheduled backups and storage contents

Best practices

• Use SSH Host entries and 2FA-friendly sessions to avoid repeated prompts
• Run discovery commands first (pct list, qm list, pvesh) to build context before changing state
• Prefer graceful shutdowns (pct shutdown / qm shutdown) and use force only when necessary
• Check journalctl -u <service> for recent logs before restarting services
• Keep a local copy of static docs (PROXMOX_SETUP.md) for IPs and persistent config details

Example use cases

• Find which container hosts a given app: list containers, inspect systemd units, check listening ports
• Debug a service that won’t respond: confirm container running, view service status, tail recent logs, then restart if needed
• Resolve storage or ZFS problems: check pvesm status, zpool status, and df -h to locate space issues
• Recover a non-starting container: inspect pct config, check for stale locks and disk availability, then start or force-stop as required
• Confirm backups: read backup job config and list backups in target storage