Document and configure DeskWEB for native Deck LTX backend

2026-09-30 15:32:46 +02:00
parent 1def49e04c
commit 9d4324bd31
3 changed files with 65 additions and 0 deletions
@@ -0,0 +1,49 @@
+# Athena Deck: LTX Original
+
+DeskWEB spricht die originale LTX-Desktop-API bereits direkt an. Für Decks
+zusätzliche native LTX-Original-Laufzeit ist kein Frontend-/Schemaadapter und
+keine neue CUDA-Umgebung in diesem Web-Container notwendig.
+
+Die Backend-Adresse bleibt in der Athena-Testinstallation
+`http://127.0.0.1:8120`. Deck schaltet zwischen OpenAI-API im LLM-Modus und
+originaler LTX-API im Video-Modus um. DeskWEB steuert keinen GPU-Modus.
+
+`deploy/compose.deck-original.yaml` ist ein zusätzlicher Compose-Override nach
+`deploy/compose.athena.yaml`. Er verbindet die neuen Medienordner mit dem
+nativen Backend. Er ersetzt nur die Mounts dieses Frontends und enthält weder
+Gewichte noch Secrets. Token und Login-Dateien bleiben wie bisher gesetzt.
+
+Vor dem Aktivieren auf Athena ausschließlich die neuen Verzeichnisse anlegen:
+
+```sh
+install -d -o 65534 -g 65534 -m 0755 \
+ /opt/athena-deck-dev/runtime/state/video/original-work
+install -d -o 1000 -g 65534 -m 2770 \
+ /opt/athena-deck-dev/runtime/state/video/original-work/remote-inputs/deskweb
+install -d -o 65534 -g 65534 -m 2750 \
+ /opt/athena-deck-dev/runtime/state/video/original-work/outputs
+```
+
+Backend: UID/GID 65534. Web-Frontend: UID 1000, gemeinsame Gruppe 65534.
+Keine rekursiven Änderungen an alten LTX-Medien, Modellen oder Secrets.
+Compose-Override benötigt Docker Compose mit `!override`-Unterstützung.
+
+```sh
+docker compose -p ltx-deskweb \
+ -f compose.yaml -f deploy/compose.athena.yaml \
+ -f deploy/compose.deck-original.yaml up -d --no-deps ltx-deskweb
+```
+
+Für ein bereits veröffentlichtes Image zusätzlich `compose.registry.yaml`
+verwenden. Andere Server benötigen angepasste absolute Host- und Backendpfade.
+Die hier genannten Backendpfade gelten innerhalb des Deck-Testcontainers;
+eine native systemd-Installation verwendet ihre tatsächlichen Hostpfade.
+
+Alte Projekte referenzieren möglicherweise Medien unter `/data/LTXDesktop/...`.
+Diese Referenzen migrieren nicht automatisch. Alte Medienordner bleiben
+unverändert erhalten; benötigte Assets in der neuen Anbindung erneut importieren.
+
+Integrationsstand 30.09.2026: Override vorbereitet, noch nicht auf Athena
+aktiviert. LAN-/SSH-Verbindung ist während der Integration ausgefallen.
+Erst nach echtem Upload-, Generierungs-, Fortschritts-, Abbruch- und Wiedergabetest
+ist die Umstellung als geprüft anzusehen.