Updates und Auto-Update

Nichts aktualisiert sich von selbst. Admin > System sagt dir, wenn ein Release da ist, du machst ein Backup, und dann bringt ein Befehl oder ein Klick die neue Version.

1. Erst ein Backup, jedes Mal

Datenbankmigrationen laufen beim Start von selbst und gehen nur vorwärts: Eine ältere Version kann ein Schema nicht nutzen, das eine neuere schon umgebaut hat. Mach also vor jedem Update ein Backup:

BACKUP_DIR=/path/to/backups ./scripts/backup.sh

Ein mit dem Einrichtungsassistenten angelegter Server hat noch keinen Ordner scripts/. Hol dir einmal die Skripte des Releases, das du betreibst; ersetze X.Y.Z durch die Version aus Admin > System:

base=https://raw.githubusercontent.com/mnema-xyz/talk/vX.Y.Zmkdir -p scripts && cd scriptsfor f in backup.sh backup-common.sh backup-online.sh restore.sh upgrade-postgres.sh health-check.sh; do curl -fsSLO "$base/scripts/$f"; donechmod +x *.sh && cd ..

Mehr dazu unter Backups und Restore.

2. Welchem Tag du folgst

MNEMA_IMAGE in der .env bestimmt, was ein Update bringt:

TagFolgtUpdate-now-KnopfKommandozeile
:X.Y (zum Beispiel :3.3)Allen Patch-Releases dieser LinieJa, bis zur nächsten Minor-Liniedocker compose pull && docker compose up -d
:latestJedem Release, auch Breaking ChangesImmerdocker compose pull && docker compose up -d
:X.Y.Z oder @sha256:…Nichts: festgenageltNein; der Tab System zeigt die SchritteZwischen Versionen wechseln

Der Einrichtungsassistent schreibt einen Tag für die Version, mit der er kam. :X.Y ist der praktische Mittelweg: Ein Fix-Release erhöht den Patch, :X.Y bekommt also nur Fixes. Auf GHCR gibt es keinen Tag :X (der Spiegel auf Docker Hub, mnemaxyz/mnema-talk, hat ihn zusätzlich).

3. Update über die Kommandozeile

Für :X.Y und :latest:

cd /path/to/mnema-talkdocker compose pull && docker compose up -d

Compose erzeugt nur die Dienste neu, deren Image sich geändert hat; die Ausfallzeit beträgt ein paar Sekunden. Offene Tabs zeigen „A new version is available – click here to reload“, und ein laufendes Gespräch verbindet sich nach dem Neuladen wieder.

Auf einem Synology ohne SSH: Container Manager > Projekt > mnema-talk > Aktion > Stopp, dann Löschen (entfernt die Container und Images des Projekts, nicht deine Daten) und Build.

Der Update-now-Knopf

Admin > System zeigt die laufende Version und das neueste Release mit seinen Hinweisen. Der Server fragt alle 30 Minuten bei GitHub nach; UPDATE_CHECK_ENABLED=false schaltet das ab.

Der optionale Updater-Sidecar fügt einen Knopf Update now hinzu. Bevor irgendetwas gezogen wird, löst er den Tag in einen einzigen Digest auf und prüft die cosign-Signatur des Images gegen den Release-Workflow dieses Projekts und die Build-Provenienz jeder Plattform. Ein Image, das älter ist als das laufende, lehnt er ab, damit ein verschobener Tag die App nicht zurückrollen kann. Dann zieht er genau diesen Digest und startet nur die App neu; alle sind für etwa 30 bis 60 Sekunden getrennt. Er fragt erneut nach dem Passwort des Owners, läuft höchstens alle 5 Minuten und wird im Audit-Log festgehalten.

Er ist standardmäßig aus. Schalte ihn ein, wenn der Einrichtungsassistent danach fragt, oder füg der .env zwei Zeilen hinzu und starte das Profil:

COMPOSE_PROFILES=autoupdate
UPDATER_TOKEN=<output of: openssl rand -hex 32>
docker compose up -d

Er braucht ein veröffentlichtes Image (keinen lokalen Build) und ausgehendes HTTPS zu ghcr.io und Sigstore.

4. Das Ergebnis prüfen

docker compose pscurl -fsS http://127.0.0.1:8080/api/healthdocker compose logs --since 10m app | grep -E 'migration applied|"level":"(WARN|ERROR)"'

Die App sollte nach etwa 15–30 Sekunden healthy sein. Admin > System zeigt die neue Version; schau dann in Admin > Status nach neuen gelben oder roten Punkten.

Lies für jedes Release, das du überspringst, seinen Eintrag in den Upgrade-Hinweisen: Bei manchen musst du vor dem Update eine Einstellung ändern. Geht etwas schief, hilft Zwischen Versionen wechseln.

Stimmt etwas auf dieser Seite nicht? Sag es uns.