- 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
60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
# Serenity
|
|
|
|
NAS, media ingestion, and CPU-based AI inference.
|
|
|
|
## Hardware
|
|
|
|
| Component | Details |
|
|
|-----------|---------|
|
|
| **IP (LAN)** | 10.5.1.5 |
|
|
| **IP (Tailscale)** | 100.94.87.79 |
|
|
| **OS** | Unraid 7.2.4 |
|
|
| **CPU** | Dual Intel Xeon X5690 (6c/12t each — 24 threads total) |
|
|
| **RAM** | 102 GB |
|
|
| **GPU** | None (Matrox G200 IPMI only) |
|
|
|
|
## Roles
|
|
|
|
- **NAS** — primary storage for Docker volumes, media, and backups via NFS
|
|
- **Media ingestion** — full ARR stack (Sonarr, Radarr, Prowlarr, qBittorrent, etc.)
|
|
- **Reranker host** — CPU-based TEI reranker for the AI RAG pipeline
|
|
|
|
## Services
|
|
|
|
### NFS Exports
|
|
|
|
| Export | Mount on PD | Purpose |
|
|
|--------|-------------|---------|
|
|
| `/mnt/user/data` | `/mnt/unraid/data` | General Docker volumes |
|
|
| `/mnt/user/immich` | `/mnt/unraid/immich` | Immich photo library |
|
|
|
|
> **Note:** NFS mounts on PD are **not** automatic at boot. Run after every TrueNAS restart:
|
|
> ```bash
|
|
> sudo bash /mnt/tank/docker/scripts/mount-unraid-nfs.sh
|
|
> ```
|
|
|
|
### Reranker (TEI)
|
|
|
|
Text Embeddings Inference reranker for OpenWebUI RAG pipeline.
|
|
|
|
| Setting | Value |
|
|
|---------|-------|
|
|
| **Model** | `BAAI/bge-reranker-v2-m3` |
|
|
| **Image** | `ghcr.io/huggingface/text-embeddings-inference:cpu-latest` |
|
|
| **Port** | `9787` |
|
|
| **Volume** | `/mnt/user/appdata/reranker` |
|
|
| **LiteLLM model name** | `reranker` |
|
|
| **API base** | `http://10.5.1.5:9787` |
|
|
|
|
> Moved from PlausibleDeniability (port 8787) to Serenity (port 9787) on 2026-05-09.
|
|
> CPU-only inference is acceptable for RAG reranking workloads.
|
|
|
|
### ARR Stack
|
|
|
|
Managed via Unraid Community Apps. See Unraid dashboard for individual service ports and status.
|
|
|
|
## Notes
|
|
|
|
- No GPU; reranker uses CPU-only TEI image
|
|
- Tailscale active — reachable at `100.94.87.79` from any Tailscale node
|