- UNAS layout decoded from the user's tree: services/<svc>/ is the homelab-wide docker config store (every container follows the same pattern — immich, karakeep, nextcloud, ntfy, paperless-ai, pocketid, shelfmark, stremio, traccar, vaultwarden, gluetun). Nexa MUST follow the same pattern at services/nexa/. backup/<svc>/ for snapshots. Pinned in CLAUDE.md and docs/12 #31. - Stale services flagged for retirement: services/siyuan/ (migrated to Obsidian) and services/open-webui/ (unused, only LobeHub is alive). Drops the "two LLM UIs" item (#15) — it's now "retire open-webui". - Hard-blocklist for any Nexa indexer pinned in CLAUDE.md: _sortMe/wallet/**, *.gpg/asc/key/pem/kdbx/credentials/secret, plus the Nextcloud appdata dir. - Three new "future user-facing wins" surfaced from the tree: Paperless-AI as a Phase-2.x triage helper for _sortMe/Downloads/, media/Recipes/ (~300 entries) as the showcase RAG corpus, and Paperless-AI's existing ChromaDB as a potential read-from source rather than re-embedding scanned docs. - Housekeeping campaign in docs/12 §35-37: consolidate postgres, audit UNAS-everywhere, S3 archive tier on s3.nuclide.systems. - Phase 6 added to the roadmap: "Nexa as homelab steward". Polls Dockge/docker/Proxmox, diffs vs documented state, emits a daily drift report. Most of the housekeeping campaign becomes semi-automatic once 6.1-6.3 ship. - New docs/13-information-wishlist.md packages the still-needed inventory as 5-6 paste-and-run tasks, each with explicit "📍 Where" markers (which shell or which UI) and what it unblocks. Highest leverage = Task 1 (read an existing compose stack to lock Q19). - docs/index.md TOC extended to 13 rows. Also fixed numbering drift in docs/12 (duplicate #28, missing #17/#18) and added Q19 to docs/11 covering the SMB-share verification step.
4.4 KiB
13 — Information Wishlist
What additional system inventory would sharpen future decisions, packaged as the smallest set of paste-and-run tasks that still answers everything material. Each task is independent — run any subset, in any order.
Each task header tells you exactly where to run it (which shell or which UI). Output goes into a Memos draft, a comment in this conversation, or docs/inventory/<NN>-<slug>.txt — whichever is easiest.
Task 1 — Stack inventory + reference compose (highest leverage)
📍 Where: Proxmox UI → Datacenter → nuc → LXC 104 (docker) → Console (or ssh root@192.168.1.40 from your PC).
Locks Q19 (the SMB share name + driver options Nexa must mirror) and replaces screenshot-derived guesses about what's running.
docker ps -a --format '{{.Names}}\t{{.Image}}\t{{.Status}}' | sort
ls /opt/stacks/
cat /opt/stacks/karakeep/compose.yaml # or any clean small stack
Unblocks: Q19, the housekeeping migration template (#36), Phase-3.1 deployment YAML.
Task 2 — Storage map (Proxmox + docker)
📍 Where: Two shells — first the Proxmox host (Datacenter → nuc → Shell, or ssh root@192.168.1.20), then back into the LXC 104 console.
Tells us which Proxmox storage backs what, and which docker volumes are local vs. SMB.
# (a) on the Proxmox host (192.168.1.20):
cat /etc/pve/storage.cfg
cat /etc/pve/lxc/104.conf
# (b) on LXC 104 (192.168.1.40):
docker volume ls
ls -l /dev/dri/ # confirms whether iGPU passthrough actually works
Unblocks: optimization #30 (iGPU), #36 (UNAS audit), B6/B7/C17.
Task 3 — Postgres / DB workload inventory
📍 Where: LXC 104 console (same shell as Task 1).
Direct input to housekeeping #35 (consolidate postgres instances).
for c in $(docker ps --format '{{.Names}}' | grep -iE 'postgres|mariadb|mysql|_db$'); do
echo "=== $c ==="
docker exec "$c" sh -c 'psql -U postgres -l 2>/dev/null || mysql -e "show databases" 2>/dev/null'
done
Unblocks: #35 (consolidate vs. migrate-to-SQLite decision).
Task 4 — LiteLLM model list for the Nexa key
📍 Where: Either the LiteLLM admin UI (one screenshot) or any shell with $SAIA_API_KEY exported.
- Screenshot path: open
https://ai.nuclide.systems(Lobehub) → Settings → Model List, filtered to the Nexa virtual key. Screenshot the model rows. - CLI path: any shell on your PC or the LXC, with
SAIA_API_KEYset:curl -sH "Authorization: Bearer $SAIA_API_KEY" \ https://ai.nuclide.systems/v1/models | jq '.data[].id'
Unblocks: Q18 follow-up — which embedding model SAIA proxies and at what dim, so we can decide if any flow can short-circuit TEI.
Task 5 — S3 archive credentials
📍 Where: s3.nuclide.systems admin UI in your browser (it's already proxied via Zoraxy — same login as the rest of the homelab).
Walk to: Buckets → either pick an existing Nexa-suitable bucket or create one called nexa → note the bucket name. Then Access Keys → create a key named nexa-snapshots with read/write on that bucket → drop the access-key + secret into Vaultwarden under "Nexa S3", and reply here with just the bucket name (the secret stays in Vaultwarden).
Unblocks: Q12, housekeeping #37 (S3 archive tier), Phase-3.3.
Task 6 — Reverse-proxy + DNS authority (only if needed)
📍 Where: two browser UIs.
- Zoraxy (
http://192.168.1.4:8000) → HTTP Proxy → either click "Export" if available, or take a full screenshot of the table. - AdGuard (
http://192.168.1.20LXC 102 web UI) → Filters → DNS Rewrites → screenshot.
Skip unless we hit a routing surprise during Phase 1.
When something else is needed
The smaller items (n8n credentials list, Memos webhook config, smartctl, sample of _sortMe/, what cron is failing) only matter when we touch that specific area. The agent will ask for them at the moment they're needed, with the same "📍 Where" framing.
Self-serve once Phase 6 ships
Once Phase 6 — Nexa as homelab steward lands, Nexa runs Tasks 1–3 itself on a schedule and folds the results into a daily drift report. This wishlist becomes a Nexa-managed surface (#nexa:wishlist-status) rather than something the user has to remember.