From 948c8a453ec1ae642782a4e18a8464c1fccb0056 Mon Sep 17 00:00:00 2001 From: mARTin-B78 Date: Mon, 7 Sep 2026 21:38:17 +0200 Subject: [PATCH] docs: track NUC deployment as a deferred TODO, blocked on DGX sudo access Recorded the exact NFS setup needed on the DGX (export the voice library read-write, scoped to the NUC's IP) so the app's voice list never drifts from what the DGX's TTS engine actually has on disk, plus the accepted cross-host limitation on voice-change auto-restart. Co-Authored-By: Claude Sonnet 5 --- TODO.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/TODO.md b/TODO.md index b5776a9..a4ff319 100644 --- a/TODO.md +++ b/TODO.md @@ -95,6 +95,26 @@ architecture change: the larger Audiobook/Rehearser/style split. locally and in the SonarQube quality workflow alongside the existing Python and bundle checks. - [x] Expose extracted Rehearser and Audiobook parser APIs through the `window.TTVC` namespace bridge. +### P2 — deployment + +- [ ] **S — Deploy the app to `correspondence-nuc` (192.168.178.19), pointed at the DGX Spark's TTS engine over the + network.** Blocked on sudo access on the DGX (no passwordless sudo in the Claude session): needs + `nfs-kernel-server` installed and `/home/sparky/Media/_Sounds/TTS_Voices` exported read-write to + `192.168.178.19` only, so the NUC's voice library never drifts from what the DGX's TTS engine actually has on + disk (the NUC only NFS-mounts Synology shares today, nothing from the DGX). `tts_url`/`vision_ocr_url` settings + already default to the DGX's LAN IP (`192.168.178.8`) and OpenAI-compatible network calls, so once the mount + exists this is mostly a new compose file + `docker compose up -d` on the NUC. Accepted limitation: voice-change + auto-restart of the DGX's TTS containers (`TTS_CONTAINER_NAME(S)`) won't work cross-host from a NUC-hosted app + instance, since `docker-socket-proxy` there only controls the NUC's own Docker socket — that's a manual restart + on the DGX after a voice change, same as today. + Commands needed on the DGX (run manually, or grant this session sudo to run them): + ``` + sudo apt-get install -y nfs-kernel-server + echo "/home/sparky/Media/_Sounds/TTS_Voices 192.168.178.19(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a /etc/exports + sudo exportfs -ra + sudo systemctl enable --now nfs-kernel-server + ``` + ### P2 — after behavior and safety stabilize - [x] **M — Add structured logs with request/job IDs.** Report provider, endpoint,