--- name: homelab-automation description: Automating homelab infrastructure. Use when managing Proxmox VMs, containers, NAS mounts, or other homelab services. version: 1.0.0 author: Philipp Rollmann tags: - homelab - proxmox - pihole - unifi - network - dns - nas - qnap - storage - infrastructure - automation requires: - python3 - requests triggers: - \/homelab - \/proxmox - \/nas - \/pihole - \/unifi --- # Homelab Automation Manage your homelab infrastructure: Proxmox VMs\/containers, Pi-hole DNS\/ad-blocking, UniFi networking, QNAP NAS mounts. ## Quick Start 1. Set up environment variables (copy `.env.example` to `.env`): ```bash PROXMOX_HOST=192.168.10.140 PROXMOX_TOKEN_ID=root@pam!homelab PROXMOX_TOKEN_SECRET=your-token-uuid PIHOLE_HOST=pihole.local PIHOLE_PASSWORD=your-password ``` 2. Test connections: ```bash python .claude\/skills\/homelab\/proxmox\/scripts\/proxmox_api.py nodes python .claude\/skills\/homelab\/pihole\/scripts\/pihole_api.py summary ``` ## Available Modules ### Proxmox VM and container management via REST API. - **[API Reference](proxmox\/API.md)** - Endpoints and authentication - **[Operations Guide](proxmox\/OPERATIONS.md)** - Common tasks - **[Python Script](proxmox\/scripts\/proxmox_api.py)** - CLI tool - **[Community Scripts](proxmox\/COMMUNITY_SCRIPTS.md)** - Quick app installation (200+ apps) ### Pi-hole DNS and ad-blocking management. - **[API Reference](pihole\/API.md)** - Endpoints and authentication - **[Operations Guide](pihole\/OPERATIONS.md)** - Common tasks - **[Python Script](pihole\/scripts\/pihole_api.py)** - CLI tool ### Network (UniFi) Network and device management (UCG, UDM, Controller). - **[API Reference](network\/API.md)** - Endpoints and authentication - **[Operations Guide](network\/OPERATIONS.md)** - Common tasks - **[Python Script](network\/scripts\/network_api.py)** - CLI tool ### Protect (UniFi) Camera and NVR management. - **[API Reference](protect\/API.md)** - Endpoints and authentication - **[Python Script](protect\/scripts\/protect_api.py)** - CLI tool ### Storage NAS mount management for LXC containers. - **[NAS Guide](storage\/NAS.md)** - QNAP integration and bind mounts ### Home Assistant Smart home automation and control. - **[API Reference](homeassistant\/API.md)** - Endpoints and authentication - **[Operations Guide](homeassistant\/OPERATIONS.md)** - Common tasks - **[Python Script](homeassistant\/scripts\/homeassistant_api.py)** - CLI tool ## Common Commands ```bash # Proxmox basics proxmox_api.py nodes # List all nodes proxmox_api.py vms # List VMs on node proxmox_api.py containers # List LXC containers proxmox_api.py start # Start VM\/container proxmox_api.py stop # Stop VM\/container # Storage proxmox_api.py storage # List storage (shows QNAP) proxmox_api.py lxc-config # Show LXC config with mounts proxmox_api.py add-mount --source \/mnt\/pve\/qnap --target \/data # Pi-hole pihole_api.py summary # Statistics summary pihole_api.py status # Blocking status pihole_api.py disable --duration 300 # Disable blocking for 5 min pihole_api.py enable # Enable blocking pihole_api.py block example.com # Add to blocklist pihole_api.py allow example.com # Add to allowlist pihole_api.py top-domains # Top 10 domains # Network (UniFi) network_api.py clients # List active clients network_api.py devices # List devices network_api.py kick aa:bb:cc:dd:ee:ff # Disconnect client network_api.py block aa:bb:cc:dd:ee:ff # Block client network_api.py restart-device # Restart device network_api.py health # Network health # Protect (UniFi) protect_api.py cameras # List cameras protect_api.py snapshot # Get snapshot protect_api.py events --last 24h # Last 24h events protect_api.py lights # List lights # Home Assistant homeassistant_api.py status # Check HA status homeassistant_api.py entities --domain light # List lights homeassistant_api.py turn-on light.living_room --brightness 200 homeassistant_api.py turn-off light.kitchen homeassistant_api.py list-automations # List all automations homeassistant_api.py trigger automation.motion_light homeassistant_api.py activate-scene scene.good_night homeassistant_api.py run-script script.morning_routine ``` ## Configuration All configuration via environment variables. See `.env.example` in project root.