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 |
| 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_SECRETfür die Sitzungen,SECRETS_ENCRYPTION_KEYfür verschlüsselte Inhalte und Backups.
Ohne
SECRETS_ENCRYPTION_KEYlassen 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