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
@@ -21,6 +21,8 @@ Prebuilt-image installation: [Container Registry](docs/CONTAINER_REGISTRY.md)

 **Vollständige manuelle Anleitung (Deutsch): [Docker Pull, Labels, Volumes, Ports und Start](docs/DOCKER_INSTALLATION_DE.md).**

+Athena Decks zusätzliche **LTX Original**-Laufzeit: [Anbindung und Medien-Mounts](docs/LTX_ORIGINAL.md).
+
 ## Debian / Docker deployment

 Prerequisites: Docker Engine + Compose; a separately configured LTX Desktop backend;
@@ -0,0 +1,14 @@
+# Additional override AFTER deploy/compose.athena.yaml. Frontend only, no GPU.
+# Provision these two new directories before activating this override.
+services:
+  ltx-deskweb:
+    user: "1000:65534"
+    environment:
+      LTX_BACKEND_URL: http://127.0.0.1:8120
+      BACKEND_INPUT_DIR: /var/lib/deck/video/original-work/remote-inputs/deskweb
+      BACKEND_OUTPUT_DIR: /var/lib/deck/video/original-work/outputs
+    volumes: !override
+      - /opt/athena-deck-dev/runtime/state/video/original-work/remote-inputs/deskweb:/data/inputs
+      - /opt/athena-deck-dev/runtime/state/video/original-work/outputs:/data/outputs:ro
+    labels:
+      org.ltx-deskweb.backend: ltx-original
@@ -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.