Wissen / Betrieb

Datensicherung und Umzug

Verschlüsselte Backups nach Zeitplan, Wiederherstellen und der Umzug auf einen neuen Server.

Kontris sichert Datenbank und Dokumente selbst in eine verschlüsselte Datei mit der Endung .chbk.

Einschalten

  1. Öffne Verwaltung → Einstellungen → Datensicherung verwalten.
  2. Schalte den Zeitplan ein und wähle Uhrzeit und Aufbewahrung in Tagen.
  3. Klicke einmal Jetzt sichern und prüfe, dass das Backup in der Liste erscheint.

Läuft der Server zur eingestellten Zeit nicht, entsteht das Backup nach dem nächsten Start.

Wo die Backups liegen

Standard ist der Ordner backups in der lokalen Dokumentablage, auf dem Server also /opt/contracthub/files/backups. Das schützt nicht vor dem Verlust der Platte. Entweder nimmst du den Ordner in die Sicherung des Servers auf, oder du wählst als Speicherort eine andere eingerichtete Ablage (S3, Azure).

Verschlüsselung

Backups sind mit einem Schlüssel verschlüsselt, der aus SECRETS_ENCRYPTION_KEY abgeleitet wird.

Ohne diesen Schlüssel ist jedes Backup wertlos. Bewahre ihn getrennt von den Backups auf, zum Beispiel im Passwortmanager.

Wiederherstellen

In der Liste der Backups oder nach dem Hochladen einer .chbk-Datei. Kontris legt vorher automatisch ein Sicherheits-Backup an, ersetzt dann die Datenbank und schreibt die Dokumente zurück. Danach sind alle Benutzer abgemeldet. Während der Wiederherstellung sehen Benutzer eine Wartungsseite.

Ein Backup aus einer neueren Version lehnt Kontris ab. Aktualisiere in dem Fall zuerst die Anwendung.

Kommandozeile

Für den Fall, dass die Oberfläche nicht erreichbar ist:

docker compose exec contracthub node dist/backup.js list
docker compose exec contracthub node dist/backup.js create
docker compose exec contracthub node dist/backup.js restore <backup-id oder pfad.chbk>
docker compose restart contracthub

Mit extract entschlüsselst du ein Backup in einen leeren Ordner. Darin liegen ein gewöhnlicher SQL-Dump und die Dateien:

docker compose exec contracthub node dist/backup.js extract <backup-id> /tmp/backup

Umzug auf einen neuen Server

  1. Alter Server: Jetzt sichern, dann Herunterladen. Ab jetzt dort nichts mehr ändern.
  2. Neuer Server: Kontris wie in der Installation beschrieben einrichten, mit demselben SECRETS_ENCRYPTION_KEY.
  3. Als Admin anmelden, das Backup hochladen und wiederherstellen. Das geht auch ohne Lizenz, das Backup bringt sie mit.
  4. Alten Server stoppen, damit nicht zwei Instanzen Erinnerungen verschicken.

Ändert sich beim Umzug die Adresse der Installation, brauchst du eine Lizenz für die neue Adresse.

PostgreSQL

Bleib bei PostgreSQL 16. Ein Wechsel auf eine höhere Hauptversion geht nicht durch Austausch des Images, sondern über ein Backup und die Wiederherstellung in eine neue, leere Datenbank.

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns