Wissen / Erste Schritte

Überblick und Voraussetzungen

Wie Kontris aufgebaut ist und was der Server mitbringen muss.

Aufbau

Kontris besteht aus zwei Containern:

  • contracthub liefert die Weboberfläche und die API aus. Der Container läuft ohne Root-Rechte und lauscht auf Port 3000.
  • contracthub-db ist eine PostgreSQL-16-Datenbank. Sie enthält alle Daten, die Sitzungen, die Hintergrundjobs und den Suchindex.

Dokumente liegen in einem Ordner auf dem Server oder in einem Objektspeicher (S3, Azure). Weitere Dienste wie Redis oder ein eigener Suchserver sind nicht nötig.

Vor Kontris steht normalerweise ein Reverse Proxy, der HTTPS bereitstellt. Ohne Proxy kann Kontris HTTPS auch selbst ausliefern, siehe HTTPS und Reverse Proxy.

Voraussetzungen

Was Anforderung
Betriebssystem Linux, zum Beispiel Debian, Ubuntu oder RHEL
Container Docker mit Compose-Plugin oder Podman ab 4.4 mit podman-compose
Ressourcen 2 CPU-Kerne, 4 GB RAM, 20 GB Platz für Images, dazu Platz für Dokumente und Backups
Adresse Ein DNS-Name für die Anwendung, zum Beispiel contracthub.example.com
Zertifikat TLS-Zertifikat für diesen Namen
Anmeldung Lokale Konten funktionieren sofort. Für Single Sign-on Microsoft Entra ID oder Authentik
Mail Ein SMTP-Server für Erinnerungen und Einladungen (optional, aber empfohlen)

Netz

Eingehend braucht Kontris nur HTTPS (Port 443) für die Benutzer. Ausgehend hängt es davon ab, was du nutzt:

Ziel Wofür
SMTP-Server Erinnerungen, Einladungen, Berichte
login.microsoftonline.com:443 Anmeldung über Entra ID
graph.microsoft.com:443 Nur für den Copilot-Connector und die Prüfung deaktivierter Entra-Konten
Adresse von Authentik oder i-doit Nur, wenn angebunden

Die Lizenz wird ohne Internetzugang geprüft. Kontris sendet keine Nutzungsdaten.

Drei Geheimnisse

Bei der Installation erzeugst du drei Werte. Bewahre sie im Passwortmanager auf:

  • das Datenbankpasswort,
  • SESSION_SECRET für die Sitzungen,
  • SECRETS_ENCRYPTION_KEY für verschlüsselte Inhalte und Backups.

Ohne SECRETS_ENCRYPTION_KEY lassen sich Backups nicht wiederherstellen. Der Schlüssel gehört getrennt von den Backups aufbewahrt.

Weiter mit der Installation.

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns