Files
truenas-stacks/docs/servers/SERENITY.md
Fizzlepoof 9e0f66c2b6
Some checks failed
secret-guardrails / artifact-secret-scan (push) Has been cancelled
secret-guardrails / gitleaks (push) Has been cancelled
docs: capture DNS resilience and Technitium backup sync
2026-05-24 02:49:23 +00:00

69 lines
2.2 KiB
Markdown

# Serenity
NAS, media ingestion, and CPU-based AI inference.
## Hardware
| Component | Details |
|-----------|---------|
| **IP (LAN)** | 10.5.30.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.30.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.
### Technitium Backup Resolver
Serenity hosts the secondary backup Technitium node on `10.5.30.10`.
- Live stack path: `/mnt/user/appdata/technitium-serenity`
- Resolver bind IP: `10.5.30.10`
- Config is refreshed from PD's live Technitium directory by the PD-side sync runner every 15 minutes
- Same-host checks from Serenity to `10.5.30.10` are unreliable because the resolver sits behind macvlan networking; verify from another LAN peer instead
## Notes
- No GPU; reranker uses CPU-only TEI image
- Tailscale active — reachable at `100.94.87.79` from any Tailscale node