Wissen / Einrichtung
Dokumentablage
Dokumente lokal, in S3 oder in Azure speichern und zwischen Ablagen umziehen.
Dokumente, Lizenzdateien und Logos liegen in genau einer Ablage. Welche, bestimmt STORAGE_DRIVER.
Lokal (Standard)
STORAGE_DRIVER=local
FILE_STORAGE_PATH=/data/files
Der Ordner ist in der compose.yaml als ./files:/data/files eingebunden und gehört UID 1000. Er muss in die Datensicherung des Servers, sofern du nicht die Backups in der App an einen anderen Ort schreiben lässt.
S3 und S3-kompatibler Speicher
STORAGE_DRIVER=s3
S3_BUCKET=contracthub
S3_REGION=eu-central-1
S3_ACCESS_KEY_ID=<Schlüssel>
S3_SECRET_ACCESS_KEY=<Geheimnis>
# optional: Ordner im Bucket
S3_PREFIX=
Für MinIO, NetApp StorageGRID und andere kompatible Server zusätzlich:
S3_ENDPOINT=https://s3.example.local
S3_FORCE_PATH_STYLE=true
Bleiben die Zugangsdaten leer, nutzt Kontris die übliche AWS-Kette (Umgebung, Instanzrolle).
Azure Files
STORAGE_DRIVER=azure-files
AZURE_FILES_CONNECTION_STRING=<Verbindungszeichenfolge>
AZURE_FILES_SHARE=contracthub
# optional: Verzeichnis in der Freigabe
AZURE_FILES_DIRECTORY=
Azure Blob Storage
STORAGE_DRIVER=azure-blob
AZURE_BLOB_CONNECTION_STRING=<Verbindungszeichenfolge>
AZURE_BLOB_CONTAINER=contracthub
# optional: Präfix im Container
AZURE_BLOB_PREFIX=
Für Azure genügt ein Kontoschlüssel oder ein SAS mit Lesen, Schreiben, Erstellen, Löschen und Auflisten.
Prüfen
docker compose exec contracthub node dist/storage.js check
Die erste Zeile nennt die aktive Ablage. Der Befehl meldet Dateien, die in der Datenbank stehen, aber in der Ablage fehlen. Dieselbe Prüfung gibt es in der App unter Verwaltung → Dateiablage.
In eine andere Ablage umziehen
-
Trage die Zugangsdaten der neuen Ablage zusätzlich in
contracthub.envein, lassSTORAGE_DRIVERaber noch auf dem alten Wert, und starte neu. -
Kopiere die Dateien:
docker compose exec contracthub node dist/storage.js copy --to s3Das geht im laufenden Betrieb. Jede kopierte Datei wird zurückgelesen und geprüft. Auf der Seite Dateiablage kannst du den Kopiervorgang ebenfalls starten.
-
Wiederhole den Befehl kurz vor dem Umschalten, damit auch zuletzt hochgeladene Dateien dabei sind. Bereits kopierte Dateien werden übersprungen.
-
Stelle
STORAGE_DRIVERauf die neue Ablage um und starte neu. -
Prüfe mit
storage.js check, ob alles da ist. Die alte Ablage kannst du danach aufräumen.
Volltextsuche in Dokumenten
Kontris liest den Text aus PDFs, Word-, Excel-, PowerPoint- und OpenDocument-Dateien sowie Textdateien und macht ihn durchsuchbar. Unter Verwaltung → Einstellungen lässt sich das abschalten. Dann werden die gelesenen Texte gelöscht. Gescannte PDFs ohne Textebene werden nicht erkannt.
Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns