Brian Pooe
a7de8cec3a
Home Assistant now pulls homelab-blueprint from Forgejo through Caddy, which needed both a UniFi zone rule (IoT -> CADDY) and a ufw allow on the Caddy host itself for the IoT subnet — two independent enforcement layers, both previously missing/misconfigured. |
||
|---|---|---|
| .. | ||
| arr-stack | ||
| immich | ||
| network | ||
| nvidia | ||
| proxmox | ||
| unas | ||
| README.md | ||
| troubleshooting.md | ||
Documentation
Operational documentation, grouped by topic. For per-stack installation guides, see the Stacks table in the root README.
Arr Stack
- Deployment: UNAS NFS, Proxmox LXC, permissions, and hardlinks.
- Recyclarr: Recyclarr configuration and sync workflow.
Proxmox
- NVMe storage layout: Fresh-install named storage layout for OS files and VM/LXC disks.
- LXC boot dependencies: Making NFS mounts and NVIDIA device nodes ready before LXCs start.
- NVIDIA GPU passthrough: Host -> LXC -> Docker for hardware transcoding.
Network
- Firewall rules: Custom UniFi firewall rules, target IPs, ports, and stateful return traffic.
- Caddy firewall policies: Zone policies that allow the Caddy DMZ host to reach apps on other VLANs.
- Rack layout: Current UNAS and MikroTik rack layout.
UNAS Storage
- NFS and SMB mounts: Persistent UniFi Drive share mounts on Proxmox and LXC bind mounts.
- In-pool share move: Move large folders between UniFi Drive shares using Btrfs reflinks without duplicating data.
Immich
- Mobile sync: Phone -> NAS -> external library sync that avoids re-upload after server-side deletes.
Troubleshooting
- Troubleshooting guide: Common stack issues and recovery steps.