# 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:

```sh
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:

```sh
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:

```sh
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](UPGRADE_INFO.md).