Home
Infrastructure-as-Code documentation for a 7-node Proxmox homelab in Montreal — Terraform, Ansible, and GitHub Actions on Proxmox.
Stack¶
- Proxmox VE — 7-node cluster (
server-mtl-01throughserver-mtl-07) - Terraform (
bpg/proxmox) with state on Backblaze B2 - Ansible for configuration management
- GitHub Actions self-hosted runners for CI/CD
- dnsmasq +
dns-api(Go) for internal DNS
Navigation¶
| Section | Key docs | Description |
|---|---|---|
| Getting Started | getting-started/ | Bootstrap and initial setup |
| Architecture | overview · networking | Global design, network, DNS, storage |
| Operations | deployment | Deployment workflow, runbooks |
| Platform | platform/ · Auth (Lab) · Auth (Tailscale) | SSH auth, certificates, Tailscale |
| Services | Monitoring | Observability stack |
| Reference | conventions | Naming, SSH, IP, global conventions |
| Roadmap | Plan (archived) · stories/ | Project phases, historical narratives |