truenas-stacks/docs/planning/HOMELAB_EXPANSION_PLAN.md

Homelab Expansion Plan

Deployment Order

1. Gotify — unified notification bus, unblocks all n8n workflows
2. Qdrant — vector DB, unblocks proper RAG pipeline
3. n8n — automation backbone, ties everything together
4. Paperless-NGX — document intelligence
5. Home Assistant — home automation layer
6. Grafana + Prometheus — unified observability

---

Phase 1 — Notifications (Gotify)

Host: PlausibleDeniability Stack: /mnt/docker-ssd/docker/compose/automation/ Storage: appdata on SSD (SQLite backend) Network: pangolin (expose as gotify.paccoco.com)

Single output target for all n8n workflows and homelab alerts.

---

Phase 2 — Vector Database (Qdrant)

Host: PlausibleDeniability Stack: /mnt/docker-ssd/docker/compose/ai/ Storage: appdata on SSD

Feed it: homelab markdown docs, Gitea commit history, Plex/Tautulli metadata, Obsidian notes.

---

Phase 3 — Workflow Automation (n8n)

Host: PlausibleDeniability Stack: /mnt/docker-ssd/docker/compose/automation/ Storage: config on tank, Postgres backend Network: pangolin (n8n.paccoco.com) + ix-databases_shared-databases

Planned Workflows

• Sonarr/Radarr webhook → Discord + Gotify notification with poster art
• Tautulli play start → log to Postgres
• Nightly watch history → Ollama → weekly digest via Gotify
• Poll Uptime Kuma → cross-reference Netdata → rich alert via Gotify
• Gitea commit to truenas-stacks → Gotify notification with Ollama summary
• qBittorrent torrent complete → trigger Sonarr/Radarr rescan
• KitchenOwl grocery list change → shopping list via Gotify
• Donetick task due → Gotify reminder
• Long and Low Crafts order → Donetick task + Gotify DM

---

Phase 4 — Document Intelligence (Paperless-NGX)

Host: PlausibleDeniability Network: pangolin (paperless.paccoco.com) + ix-databases_shared-databases

OCR and full-text search. Key for Long and Low Crafts invoices, receipts, and manuals.

---

Phase 5 — Home Automation (Home Assistant)

Host: PlausibleDeniability or N.O.M.A.D. Storage: config on SSD (SQLite, write-heavy) Network: host networking recommended for device discovery

---

Phase 6 — Observability (Grafana + Prometheus)

Host: N.O.M.A.D. Storage: Prometheus data on hdd-1 or hdd-2

Metrics to scrape: ZFS pool health, container CPU/RAM, Plex streams, qBittorrent, Tailscale latency, Netdata endpoints.

---

Multi-Model Routing Strategy

Machine	GPU	Model	Use Case
ROCINANTE	RTX 4090 (24GB)	qwen3:32b / deepseek-r1:32b	Heavy reasoning, long context
PlausibleDeniability	RTX 2080 Ti (11GB)	qwen2.5:14b	General homelab assistant, RAG
N.O.M.A.D.	GTX 1080 (8GB)	phi4 / llama3.2:3b	Fast local inference

---

Additional Tools

• Continue.dev — VS Code plugin, local Copilot alternative
• Obsidian + Gitea Sync — personal notes → RAG pipeline
• Homepage Ollama Widget — VRAM usage dashboard widget
• kima-hub — self-hosted Spotify alternative
• dispatcharr — planned
• bytestash — planned

---

Target Architecture

Triggers (Sonarr, Radarr, Tautulli, Gitea, Home Assistant, schedules, email)
        ↓
      n8n (routing, logic, orchestration)
        ↓
    Ollama (intelligence — model selected by complexity)
      ↓  ↑
    Qdrant (semantic context retrieval)
        ↓
     Outputs (Gotify → phone, Donetick tasks, Postgres logging, Discord)