truenas-stacks/docs/README.md

Homelab Documentation

Central index for all homelab infrastructure documentation.

Servers

File	Description
PlausibleDeniability	Primary Docker host — TrueNAS Scale, RTX 2080 Ti
Serenity	NAS + media ingestion — Unraid, dual Xeon X5690
N.O.M.A.D.	Offline knowledge / game servers — Ubuntu, GTX 1080
Rocinante	Heavy AI inference — RTX 4090

Architecture

File	Description
Architecture Overview	Full stack diagram and service map
Services Directory	All services with hosts, ports, and status
Networking Model	VLANs, firewall policy, DHCP DNS, and remote access
PD Future-State Topology	Visual target-state diagram for the PD rebuild, cyber VM lane, and Serenity retirement
AI Services Network	Cross-stack Docker networking for AI services

Stacks

File	Description
AI Stack	LiteLLM, OpenWebUI, Qdrant, Whisper, SearXNG
Media Stack	Plex, Tautulli, Audiobookshelf, Calibre
Home Automation	Home Assistant, KitchenOwl, DoneTick
Infrastructure	Homepage, Uptime Kuma, Gitea, Gotify

Planning

File	Description
Expansion Plan	6-phase buildout — all phases complete as of 2026-05-06
PD Future-State Architecture	Target-state host layout, storage model, cyber VM policy, and Serenity retirement path
Serenity Docker Audit	Live-audited keep/move/retire container baseline for Serenity cleanup
Serenity Cleanup Wave 1	First safe cleanup pass: legacy Pi-hole removal, stale container pruning, and DB-app migration ordering
Serenity Majority Migration Plan	Kanban-ready post-D7 plan for what stays, what retires, and what moves only after PD storage ownership changes
TODO	Active and backlog tasks

Operations

File	Description
DNS Resilience	Technitium backup-node topology, PD sync automation, fallback semantics, and validation SOP
Backup Policy	Backup scope, database dumps, and restore cadence
PD Backup Deployment	Live PD backup runner deployment details
Secrets Management	.env handling, encrypted backups, and incident guardrails