homelab-blueprint/docs/README.md
Brian Pooe 1815beadf4 refactor: restructure docs, sync stacks with Caddyfile, harden compose templates
- Add compose stacks for apps already proxied by Caddy: bento-pdf,
  it-tools, paperless-ngx, and beszel-hub (with Makefile targets)
- Remove the unused Vault stack and the drawio Caddyfile block
- Fix Caddyfile gramps upstream to port 80 to match the compose file
- Bring immich and gramps-web up to the shared template pattern
  (no-new-privileges, log rotation, memory limits, healthchecks)
- Single-quote vaultwarden SSO_AUDIENCE_TRUSTED so regex values like
  ^\d{18}$ render as valid YAML
- Move root docs into kebab-case topic folders, rebuild the docs index
  to cover every doc, and fix all broken links
2026-07-03 17:45:16 +02:00

1.6 KiB

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

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