# 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

---
