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

Ziel: git.casaderoll.de/michael/ltx-deskweb:0.1.0-5b887df

Architektur: linux/amd64 (Athena / Debian auf x86-64). Quellstand: 5b887df, einschließlich des Fixes für gemeinsam lesbare Uploads. Das Image ist bereits auf Athena gebaut. Die Veröffentlichung wartet noch auf einen autorisierten Registry-Login. Solange dieser Abschnitt nicht aktualisiert ist, ist der folgende Pull-Befehl eine Installationsvorbereitung, kein Nachweis, dass das Paket bereits verfügbar ist.

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.