Claude Code plugin for managing Ubuntu VMs hosted on Proxmox. Covers Proxmox host inspection, VM lifecycle, Docker deployments, XFS storage, Cloudflare Tunnels, backups, and system health — with a setup wizard to tailor the environment to any server.
npx claudepluginhub danielrosehill/proxmox-manager-pluginCheck the status of backup operations — recent completions, failures, storage consumption, and orchestrator service health.
Verify backup CLI tools are installed, authenticated, and functional — rclone, aws-cli, restic, rsync, and others.
Run comprehensive hardware benchmarks and save a profile to hw-profile/ with CPU, memory, storage, and I/O results.
Identify inactive Docker deployments, dangling images, stopped containers, and unused volumes — candidates for cleanup (does NOT delete anything automatically).
List and analyse all Docker deployments — active, inactive, running containers, and their git status.
Comprehensive Docker health check — daemon status, container health, resource usage, and disk consumption.
Generate a comprehensive server documentation snapshot covering OS, hardware, services, Docker deployments, and network configuration.
Check GPU passthrough status and NVIDIA/AMD GPU health inside the VM.
Check this VM's status from the Proxmox host perspective — resource allocation, GPU passthrough, snapshots, and host-side backups.
Check software RAID, LVM, and individual disk health (SMART) for the VM's storage array.
Perform a comprehensive VM system health check covering CPU, memory, swap, disk, and I/O.
Examine system and service logs for errors, warnings, and noteworthy events across journald, kernel, auth, and Docker.
Review systemd service status — failed services, frequent restarters, and critical service health.
Check resource pressure and alert thresholds — CPU load, memory, swap, disk I/O, and OOM events.
Verify connectivity to key LAN systems — gateway, NAS, Proxmox host, and other configured hosts.
Check VM network configuration, connectivity to gateway and internet, DNS resolution, and listening ports.
Check Cloudflare Tunnel status, recent errors, active ingress routes, and resource usage.
Interactive setup wizard that gathers environment details and tailors the Proxmox server management configuration to the user's specific setup.
Check SSL/TLS certificate status and expiration for Let's Encrypt, certbot, and service certificates.
Comprehensive security audit — authentication, open ports, firewall, updates, Docker security, and credential exposure.
Check NFS mounts and NAS availability — verify mounts, test connectivity, and identify stale handles.
Analyse disk space consumption and identify the largest directories and files.
XFS-specific filesystem health check — metadata integrity, fragmentation, mount options, and I/O metrics.
Check for available system updates, security patches, and whether a reboot is required.
Manages, troubleshoots, and optimises backup operations — orchestrator health, individual job status, storage usage, retention policies, and module development.
Manages Docker deployments using the atomic deployment pattern — one Git repository per service. Creates, updates, and documents deployments with proper volume management and version control.
Diagnoses and resolves Docker-related issues — container health, networking, volumes, resource constraints, and daemon problems.
Performs comprehensive security audits for Ubuntu home-lab servers — authentication hardening, patch status, firewall review, Docker security, and credential exposure checks.
Manages XFS filesystems, software RAID/LVM, NFS/NAS mounts, and cloud object storage (rclone/S3-compatible). Handles health checks, capacity planning, and backup storage organisation.
Manages and troubleshoots Cloudflare Tunnel connectivity — daemon health, ingress route configuration, authentication, and performance optimisation.
A Claude Code plugin for managing Ubuntu VMs hosted on Proxmox. It provides slash commands and agents covering Proxmox host inspection, VM lifecycle, Docker deployments, XFS storage, Cloudflare Tunnels, backups, security auditing, and general system health — with a setup wizard to tailor the context to any server.
This plugin is designed for the common home-lab pattern: an Ubuntu VM running inside Proxmox, hosting Docker services, a backup orchestrator, and external services exposed via Cloudflare Tunnel. All commands are parameterised so they work with any LAN topology.
Start with /proxmox-setup to let Claude gather your environment details and produce a customised CLAUDE.md for your server.
| Command | Description |
|---|---|
/proxmox-setup | Interactive wizard — gathers environment details and generates a tailored CLAUDE.md |
| Command | Description |
|---|---|
/proxmox-status | Check VM status, resource allocation, GPU passthrough, and snapshots from the Proxmox host |
/system-health | CPU, memory, swap, disk, and I/O health check |
/gpu-status | GPU passthrough confirmation and NVIDIA/AMD driver health |
/raid-status | Software RAID, LVM, and SMART disk health |
| Command | Description |
|---|---|
/docker-health | Comprehensive Docker daemon and container health check |
/deployment-list | List active and inactive deployments with git status |
/cleanup-docker | Identify Docker cleanup candidates — does NOT delete automatically |
| Command | Description |
|---|---|
/disk-usage | Disk space analysis and top space consumers |
/xfs-check | XFS filesystem health, fragmentation, and I/O metrics |
/check-nfs-mounts | NFS mount status and NAS connectivity |
| Command | Description |
|---|---|
/network-health | Interface, gateway, DNS, and port check |
/check-lan-connectivity | Ping gateway, NAS, Proxmox host, and other LAN systems |
/tunnel-status | Cloudflare Tunnel daemon health and ingress route status |
| Command | Description |
|---|---|
/backup-status | Recent backup job status, failures, and storage usage |
/verify-backup-tools | Confirm rclone, aws-cli, restic, rsync, etc. are installed and authenticated |
| Command | Description |
|---|---|
/security-audit | Comprehensive security audit — auth, ports, firewall, Docker, credentials |
/certificate-check | SSL/TLS certificate expiry and certbot renewal status |
| Command | Description |
|---|---|
/check-services | Failed and degraded systemd services |
/analyze-logs | System-wide log analysis for errors and noteworthy events |
/resource-alerts | CPU, memory, swap, and I/O pressure thresholds |
| Command | Description |
|---|---|
/check-updates | Available apt updates, security patches, and reboot requirement |
| Command | Description |
|---|---|
/benchmark-hardware | CPU, memory, and disk I/O benchmarks saved to hw-profile/ |
/document-server | Full server snapshot saved to context/ |
| Agent | Description |
|---|---|
docker-troubleshooter | Diagnose and resolve Docker issues — containers, networking, volumes |
deployment-manager | Create and manage atomic Docker deployments (one repo per service) |
storage-manager | XFS, RAID, NAS, and cloud storage management |
tunnel-manager | Cloudflare Tunnel configuration and troubleshooting |
backup-manager | Backup orchestrator health, module development, and troubleshooting |
security-auditor | Comprehensive security audit and hardening recommendations |
| Skill | Description |
|---|---|
proxmox-server-context | Guide for building and maintaining a server CLAUDE.md |
claude mcp add proxmox-manager github:danielrosehill/proxmox-manager-plugin
Or clone and install locally:
gh repo clone danielrosehill/proxmox-manager-plugin ~/.claude/plugins/proxmox-manager-plugin
/proxmox-setup to let Claude ask about your environment/system-health to verify everything is working/proxmox-status to confirm Proxmox host SSH access/cleanup-docker) never delete anything automatically — they always present candidates for user approvalTeam-oriented workflow plugin with role agents, 27 specialist agents, ECC-inspired commands, layered rules, and hooks skeleton.
Uses power tools
Uses Bash, Write, or Edit tools
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Comprehensive startup business analysis with market sizing (TAM/SAM/SOM), financial modeling, team planning, and strategic research
Comprehensive .NET development skills for modern C#, ASP.NET, MAUI, Blazor, Aspire, EF Core, Native AOT, testing, security, performance optimization, CI/CD, and cloud-native applications
Semantic search for Claude Code conversations. Remember past discussions, decisions, and patterns.
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification