proxmox-infrastructure

Automate Proxmox VM provisioning, template creation, and API-driven operations.

22|1|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/basher83/lunar-claude --skill proxmox-infrastructure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proxmox-infrastructure
Source: https://github.com/basher83/lunar-claude/tree/main/plugins/infrastructure/proxmox-infrastructure/skills/proxmox-infrastructure
Command: npx skills add https://github.com/basher83/lunar-claude --skill proxmox-infrastructure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires proxmoxer, requests.

What problem does it solve?

Proxmox infrastructure automation often involves repetitive VM provisioning, template creation, network configuration, and storage management across a Proxmox VE cluster. This Skill consolidates those tasks into a single, repeatable workflow to save time and reduce errors.

Core Features & Use Cases

  • VM provisioning from templates: Create and configure VMs with cloud-init-ready templates, including SSH keys and IP configuration.
  • Template creation & management: Automate template lifecycle, including cloning and converting templates for rapid deployment.
  • Networking & CEPH integration: Manage VLANs, bridges, and CEPH storage pools across nodes, including QEMU guest agent integration for reliable IP detection.
  • API-driven automation: Interact with Proxmox API via Python or Ansible to orchestrate multi-node deployments.
  • Use Case: Spin up a 3-node Proxmox cluster with identical VM templates and network configuration across all nodes in minutes, then monitor with built-in health checks.

Quick Start

Run the cluster status script to view current cluster health: ./tools/cluster_status.py --node foxtrot Validate a template with ID 9000 on a specific node: ./tools/validate_template.py --template-id 9000 --node foxtrot Check CEPH health: ./tools/check_ceph_health.py --node foxtrot --json

Frequently Asked Questions about proxmox-infrastructure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate VM provisioning on a Proxmox cluster?

Automate VM provisioning by creating cloud-init templates, then cloning and configuring them via the Proxmox API using Python or Ansible. The Skill handles template setup with SSH keys, IP configuration, virtio-scsi, serial console, and guest-agent integration across your cluster nodes in a single workflow.

Can I manage Proxmox networking and storage automation together?

Yes. This Skill orchestrates both networking—VLANs, bridges, bonds, and MTU settings—and CEPH storage pools across nodes simultaneously. Network configuration integrates with guest-agent IP detection and storage management in unified Python, Ansible, or OpenTofu workflows.

What's the best way to set up cloud-init templates for rapid VM deployment?

Create templates with cloud-init support, inject SSH keys and IP configuration, validate with the built-in template validation tool, then clone across cluster nodes. The Skill automates template lifecycle management and conversion for repeatable, multi-node deployments in minutes.

Do I need the QEMU guest agent for Proxmox VM automation?

For reliable IP detection and guest-level integration during automated VM provisioning, the QEMU guest agent is required. This Skill includes guest-agent setup, integration steps, and IP detection logic as part of its VM configuration workflow.

How do I validate Proxmox templates and cluster health before deployment?

Use the included validation and health-check tools: validate templates by ID on specific nodes, check CEPH health, and run cluster status checks. These scripts confirm your infrastructure is ready before orchestrating multi-node VM provisioning.

Can I use Ansible or Python to drive Proxmox API operations across multiple nodes?

Yes. This Skill provides API-driven automation via Python (proxmoxer library) and Ansible for multi-node cluster operations. Both interfaces handle VM provisioning, template management, networking, and CEPH orchestration across your Proxmox VE infrastructure.