Files
truenas-stacks/docs/planning/HOMELAB_EXPANSION_PLAN.md
Fizzlepoof d44e777a38 docs: update all documentation to reflect deployed state (2026-05-09)
- docs/README.md: add full documentation index (was empty)
- docs/servers/ROCINANTE.md: create new server doc (RTX 4090, heavy inference)
- docs/servers/SERENITY.md: fix CPU spec (dual X5690, not single); add reranker service
- docs/architecture/SERVICES_DIRECTORY.md: fill in all service ports (was all dashes)
- docs/architecture/ARCHITECTURE_OVERVIEW.md: mark all services as deployed
- docs/planning/HOMELAB_EXPANSION_PLAN.md: mark all 6 phases complete
2026-05-09 11:14:04 -05:00

2.3 KiB

Homelab Expansion Plan

Status: All 6 phases complete as of 2026-05-06.


Summary

Phase Description Status Completed
1 Notifications & Alerting Complete 2026-05-05
2 AI Stack Complete 2026-05-05
3 Workflow Automation Complete 2026-05-05
4 Document & Knowledge Management Complete 2026-05-05
5 Home Automation Complete 2026-05-06
6 Observability Complete 2026-05-06

Phase 1 — Notifications & Alerting COMPLETE

Goal: Centralized push notifications for all services.

  • Gotify deployed on PD (port 8443)
  • Integrated with Uptime Kuma, n8n, and Home Assistant
  • TLS via reverse proxy

Phase 2 — AI Stack COMPLETE

Goal: Self-hosted LLM inference with RAG and web search.

  • LiteLLM (4000) — unified proxy to Ollama tiers (N.O.M.A.D. light, Rocinante heavy)
  • OpenWebUI (8282) — chat UI with RAG, STT, and web search
  • Qdrant (6333/6334) — vector store for RAG
  • Whisper (8786) — CUDA speech-to-text on RTX 2080 Ti
  • SearXNG (8888) — private search backend
  • Reranker — TEI bge-reranker-v2-m3; initially on PD (8787), moved to Serenity (9787) on 2026-05-09

Phase 3 — Workflow Automation COMPLETE

Goal: Event-driven automation across all services.

  • n8n (5678) deployed on PD
  • Connected to Gotify, Home Assistant, Paperless, and Immich
  • Shared Postgres + Redis via ix-databases_shared-databases network

Phase 4 — Document & Knowledge Management COMPLETE

Goal: Paperless document ingestion and local knowledge base.

  • Paperless-NGX (8083) deployed on PD
  • OCR pipeline with automatic tagging
  • Documents stored on Serenity NFS

Phase 5 — Home Automation COMPLETE

Goal: Unified smart home control and local-first IoT.

  • Home Assistant (8123) deployed on PD
  • Kima Hub (3333) — custom IoT gateway
  • Integrated with n8n for automations and Gotify for push alerts

Phase 6 — Observability COMPLETE

Goal: Full metrics collection and dashboards.

  • Prometheus (9090) — scrapes all services and Docker stats
  • Grafana (3000) — dashboards for system health, Docker, and AI usage
  • MeshMonitor (8081) — network mesh visibility