LTX-DeskWEB/docs/CONTAINER_REGISTRY.md

Fertiges Image vom Git-Server beziehen

Die Container Registry ist ein separater Paketbereich desselben Git-Servers. Images gehören nicht als große Binärdateien in die Git-Historie. Der Quellcode, Dockerfile und die Compose-Dateien bleiben im Repository.

Aktueller Veröffentlichungsstand

Veröffentlicht am 29. September 2026: git.casaderoll.de/michael/ltx-deskweb:0.1.0-9ff96db

Architektur: linux/amd64 (Athena / Debian auf x86-64). Quellstand: 9ff96db, einschließlich der Upload-Rechte und der Browser-Höhenkorrektur.

Registry-Digest (OCI-Index): sha256:3555ed4c826ef0b0f613edf4fcffa52e951fe772fb99c1b642787f4dfd952869

Push, Registry-Manifest und authentifizierter Pull wurden erfolgreich geprüft. Der Pull-Test erfolgte auf Athena mit bereits vorhandenen Layern; ein Download auf einem vollständig leeren Host wurde nicht separat ausgeführt.

Direkt herunterladen:

docker pull git.casaderoll.de/michael/ltx-deskweb:0.1.0-9ff96db

Vollständige Einrichtung einschließlich docker run, Labels, Volumes, Rechten und Ports: Docker-Installationsanleitung.

Manuelle Installation ohne lokalen Image-Build

Repository klonen und .env, Secrets sowie gemeinsame Medienverzeichnisse wie in README.md beschrieben einrichten. Zugangsdaten niemals in Git speichern. Bei privaten Paketen auf dem Zielserver interaktiv anmelden:

docker login git.casaderoll.de --username michael

Ein eventuell verwendeter Zugriffstoken benötigt zum Veröffentlichen Paket-Schreibrechte, zum Herunterladen Leserechte. Rechteumfang und Sichtbarkeit im Git-Server prüfen; die Anwendung nicht unbeabsichtigt öffentlich freigeben. Passwort/Token interaktiv eingeben, nicht als Befehlsargument oder Chatnachricht.

Fertiges Image herunterladen und starten:

docker compose -f compose.yaml -f compose.registry.yaml pull ltx-deskweb
docker compose -f compose.yaml -f compose.registry.yaml up -d --no-build ltx-deskweb

Für Athenas bestehende Loopback-Verbindung zusätzlich das Host-Override verwenden:

docker compose -p ltx-deskweb -f compose.yaml -f compose.registry.yaml \
  -f deploy/compose.athena.yaml pull ltx-deskweb
docker compose -p ltx-deskweb -f compose.yaml -f compose.registry.yaml \
  -f deploy/compose.athena.yaml up -d --no-build --no-deps ltx-deskweb

Die Deck-Labels werden aus compose.yaml übernommen. Dieser Container enthält nur die GUI, ihren Webdienst und ffmpeg, keine LTX-Modelle oder GPU-Laufzeit. Diese Anleitung ersetzt nicht die separate Einrichtung des LTX-Backends.

Versionen veröffentlichen

• Geprüften Quellstand bauen und mit eindeutiger Version/Commit-Kennung markieren.
• Image in git.casaderoll.de/michael/ltx-deskweb pushen.
• Registry-Manifest und Digest prüfen; anschließend Pull testen.
• Veröffentlichten Digest und Tests hier bzw. in den Release-Notizen dokumentieren.
• Versionstags nicht mit späteren Builds überschreiben; keine unkontrollierten Produktivupdates über latest.
• Für eine neue Version LTX_DESKWEB_IMAGE in .env auf den geprüften Tag oder git.casaderoll.de/michael/ltx-deskweb@sha256:... setzen.

Ein fertiges Image muss nicht von der Zielmaschine gebaut werden. Ein zukünftiger CI-Workflow kann das Bauen und Veröffentlichen übernehmen; ein solcher Workflow ist derzeit noch nicht eingerichtet. Upgrade-Ablauf: UPGRADE_INFO.md.