- 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
82 lines
2.3 KiB
Markdown
82 lines
2.3 KiB
Markdown
# 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
|
|
|
|
---
|