Wissen / Betrieb

Updates

Eine neue Version einspielen und bei Bedarf zurückgehen.

Ablauf

  1. Backup erstellen: Verwaltung → Einstellungen → Datensicherung verwalten → Jetzt sichern.

  2. Neue Version holen:

    docker pull <registry>/contracthub:<neue-version>

    Ohne Internetzugang lädst du das Paket der neuen Version mit docker load, siehe Installation.

  3. Version eintragen: In compose.yaml die Zeile image: des Dienstes contracthub auf die neue Version ändern.

  4. Neu starten:

    docker compose up -d
    docker compose logs -f contracthub

Die Datenbank wird beim Start automatisch auf den neuen Stand gebracht. Das Log zeigt die neue Version.

Im Browser

Geöffnete Browser erkennen die neue Version und zeigen „Eine neue Version ist verfügbar“. Ein Klick auf Neu laden genügt. Hängt ein Browser fest, hilft Benutzermenü → Cache leeren und neu laden.

Die laufende Version steht unten in der Seitenleiste. Ein Klick darauf öffnet das Änderungsprotokoll.

Zurück zur vorherigen Version

Die Datenbank wird bei einem Update verändert. Der Weg zurück führt deshalb über das Backup von vor dem Update:

  1. In compose.yaml die vorherige Version eintragen und docker compose up -d ausführen.

  2. Das Backup wiederherstellen:

    docker compose exec contracthub node dist/backup.js restore <backup-id>
    docker compose restart contracthub

Migrationen von Hand

Wer die Änderungen an der Datenbank kontrolliert ausführen möchte, setzt RUN_MIGRATIONS=false und startet vor dem Update:

docker compose run --rm contracthub node dist/migrate.js

Aufräumen

docker image prune -a

löscht Images, die kein Container mehr verwendet.

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns