From 9d4324bd3132463b95596356aabc1fdc4ab2dd3f Mon Sep 17 00:00:00 2001
From: Mikei386 <44135113+Mikei386@users.noreply.github.com>
Date: Wed, 30 Sep 2026 15:32:46 +0200
Subject: [PATCH] Document and configure DeskWEB for native Deck LTX backend

---
 README.md                         |  2 ++
 deploy/compose.deck-original.yaml | 14 +++++++++
 docs/LTX_ORIGINAL.md              | 49 +++++++++++++++++++++++++++++++
 3 files changed, 65 insertions(+)
 create mode 100644 deploy/compose.deck-original.yaml
 create mode 100644 docs/LTX_ORIGINAL.md

diff --git a/README.md b/README.md
index 2086e8c..9250512 100644
--- a/README.md
+++ b/README.md
@@ -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;
diff --git a/deploy/compose.deck-original.yaml b/deploy/compose.deck-original.yaml
new file mode 100644
index 0000000..f4ec16a
--- /dev/null
+++ b/deploy/compose.deck-original.yaml
@@ -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
diff --git a/docs/LTX_ORIGINAL.md b/docs/LTX_ORIGINAL.md
new file mode 100644
index 0000000..0ee9838
--- /dev/null
+++ b/docs/LTX_ORIGINAL.md
@@ -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.