Wissen / Erste Schritte
Erste Anmeldung und Lizenz
Das Einmalpasswort des ersten Admins, die Testphase und das Einspielen der Lizenz.
Erster Admin
Beim ersten Start mit leerer Datenbank legt Kontris einen lokalen Admin an und schreibt dessen Einmalpasswort einmalig ins Log:
docker compose logs contracthub | grep -A8 "initial administrator"
Kontris first start: initial administrator created
URL: https://contracthub.example.com
User: admin
Password: oARsjgquKVDBCR29WrLt
- Öffne die Adresse und melde dich unter Lokales Konto mit
adminund dem Einmalpasswort an. - Vergib ein neues Passwort.
- Richte den zweiten Faktor ein: Authenticator-App oder Passkey. Die Wiederherstellungscodes gehören in den Passwortmanager.
Den Namen des ersten Admins legst du bei Bedarf vorher mit INITIAL_ADMIN_USERNAME fest.
Passwort verloren
docker compose exec contracthub node dist/reset-admin-password.js
docker compose exec contracthub node dist/reset-admin-password.js <benutzer> --reset-mfa
Der Befehl setzt ein neues Einmalpasswort, hebt eine Sperre auf und entfernt mit --reset-mfa auch den zweiten Faktor. Er gilt nur für lokale Konten und steht im Audit-Log.
Testphase
Eine neue Installation läuft 30 Tage ohne Lizenz. Ein Hinweis über jeder Seite zeigt die verbleibenden Tage. Danach ist Kontris gesperrt, bis eine Lizenz eingespielt wird. Die Daten bleiben erhalten.
Zum Ausprobieren kannst du einen Demo-Datensatz laden. Setze dafür DEMO_MODE=true in contracthub.env und starte den Container neu. Die Daten liegen im Ordner „Demo“ und verschwinden mit DEMO_MODE=false wieder.
Lizenz einspielen
Die Lizenz ist ein einzeiliger Text, der mit CHL2. beginnt. Sie gilt für die Adresse deiner Installation (APP_BASE_URL).
- Öffne als Admin
https://<deine-adresse>/admin/license. Der Sperrbildschirm und die Hinweise zur Lizenz verlinken die Seite ebenfalls. - Füge den Text ein und klicke Lizenz einspielen. Zeilenumbrüche aus der Mail stören nicht.
Per Kommandozeile geht es auch:
docker compose exec contracthub node dist/license.js install 'CHL2.…'
docker compose exec contracthub node dist/license.js status
Was du über die Lizenz wissen solltest
- Ablauf: Ab 30 Tagen vor dem Ende sehen Admins einen Hinweis und bekommen Mails. Nach dem Ende folgt eine Kulanzzeit, danach die Sperre. Mit einer neuen Lizenz läuft alles sofort weiter.
- Benutzerzahl: Enthält die Lizenz eine Obergrenze, zählen alle aktiven Benutzer. Ist sie erreicht, lassen sich keine weiteren anlegen.
- Gesperrt heißt nicht verloren: Auch ohne gültige Lizenz können Admins sich anmelden, die Lizenz einspielen und Backups erstellen oder wiederherstellen.
Nächste Schritte
- Mailversand einrichten, damit Erinnerungen ankommen
- Single Sign-on über Entra ID oder Authentik
- Datensicherung einschalten
Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns