homelab-infra

Source of truth for what runs on the Proxmox cluster. Each directory is one LXC/stack. Deploy by pulling the repo on the LXC and applying the dir's contents. See proxmox-storage-plan.md for the storage and HA model.

Stack-to-LXC mapping

Stack	LXC	Node	Storage	Type	Notes
adguard	lxc-adguard-1	pve1	local	raw	HA clone; synced via adguard/sync.sh
adguard	lxc-adguard-2	pve2	local	raw	HA clone
reverse-proxy	lxc-caddy-1	pve1	local	raw	HA clone; HTTPS on 443
reverse-proxy	lxc-caddy-2	pve2	local	raw	HA clone
nextcloud-stack	lxc-nextcloud	pve1	fast	Docker	stateful; replicate to pve4
paperless-stack	lxc-paperless	pve2	fast	Docker	stateful; replicate to pve4
monitoring-stack	lxc-monitoring	pve3	fast	Docker	stateful; replicate to pve4
forgejo	103	pve1	fast	raw	git SSH on 2222 (router fwd); see forgejo/README.md
linkwarden	104	pve1	—	raw	helper-script install; bookmark manager
navidrome	105	—	fast	raw	music on TrueNAS NFS (ro) → /mnt/music; see navidrome/README.md

Stateful services (forgejo, navidrome, nextcloud, paperless, monitoring) run as single instances on fast and tolerate downtime on node failure — restored from pve4's rpool/tank/backups snapshots. Stateless critical services (adguard, reverse-proxy) are cloned-and-running on N nodes for zero-RTO.