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

  1. Trage die Zugangsdaten der neuen Ablage zusätzlich in contracthub.env ein, lass STORAGE_DRIVER aber noch auf dem alten Wert, und starte neu.

  2. Kopiere die Dateien:

    docker compose exec contracthub node dist/storage.js copy --to s3

    Das geht im laufenden Betrieb. Jede kopierte Datei wird zurückgelesen und geprüft. Auf der Seite Dateiablage kannst du den Kopiervorgang ebenfalls starten.

  3. Wiederhole den Befehl kurz vor dem Umschalten, damit auch zuletzt hochgeladene Dateien dabei sind. Bereits kopierte Dateien werden übersprungen.

  4. Stelle STORAGE_DRIVER auf die neue Ablage um und starte neu.

  5. 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