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

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

## 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).