Homelab Guest Onboarding

Day-to-day CT/VM management — listing, starting, stopping, and adding new guests.

Common Operations

# List all CTs/VMs
pct list
qm list

# Start/stop/restart
pct start <CT_ID>
pct stop <CT_ID>
pct reboot <CT_ID>

# Shell access
pct enter <CT_ID>

Note: These commands execute on a Proxmox host (workhorse/pve/intel1), not inside a guest CT.

Onboarding a New Guest

1. Create CT/VM on appropriate Proxmox host
2. Add to hosts.yml on admin01 with IP, role, aliases (inventory at /root/homelab/inventory/hosts.yml)
3. Run python3 /root/homelab/scripts/generate.py to regenerate configs (generates SSH config, Caddyfile, etc.)
4. Deploy Caddy routes if service needs external access (adds to caddy_routes in hosts.yml first)
5. Add SSH key
6. Run homelab-sync on workstations
7. Update wiki Homelab Fleet page

Skill Reference

• homelab-guest — day-to-day management (at /root/.hermes/skills/devops/homelab-guest/)
• homelab-onboard — full provisioning workflow (at /root/.hermes/skills/devops/homelab-onboard/)
• homelab-caddy — Caddy route management (at /root/.hermes/skills/devops/homelab-caddy/)

Related

• Homelab Fleet
• Homelab Operations Ssh
• Caddy Routes