homelab

Infrastructure-as-code for a 3-node self-hosted environment. The machines are disposable: this repository plus the restic backups are the source of truth. All pages are generated from verified node state — process lists, unit files, exports, timers and container manifests.

node	function
pi-home	DNS/DHCP, identity, vault, notifications, public tunnel, backup target
vps-apps	application fleet: data services, media pipeline, agents, backup cockpit
vps-net	mesh control plane only — minimal by design

Reference pages:

• Nodes — hardware + every running service per node
• Networking — overlays, DNS, ingress, access topology
• Backups — restic matrix, exclusions, recovery pointers
• Runbooks — recovery procedures

Conventions

• Hostnames, addresses and credentials are environment values; these pages use placeholders (<node>, <user>, <domain>) and never embed them.
• Anything not described here is not guaranteed: changes to the fleet must land in this repo or they can be lost.