Knowledge base / Getting started
First sign-in and license
The first admin's one-time password, the trial and installing the license.
First admin
On the first start with an empty database Kontris creates a local admin and writes its one-time password to the log once:
docker compose logs contracthub | grep -A8 "initial administrator"
Kontris first start: initial administrator created
URL: https://contracthub.example.com
User: admin
Password: oARsjgquKVDBCR29WrLt
- Open the address and sign in under Local account with
adminand the one-time password. - Set a new password.
- Set up the second factor: authenticator app or passkey. Keep the recovery codes in your password manager.
If needed, set the first admin’s name beforehand with INITIAL_ADMIN_USERNAME.
Lost password
docker compose exec contracthub node dist/reset-admin-password.js
docker compose exec contracthub node dist/reset-admin-password.js <user> --reset-mfa
The command sets a new one-time password, lifts a lock and, with --reset-mfa, also removes the second factor. It works for local accounts only and is recorded in the audit log.
Trial
A new installation runs for 30 days without a license. A notice above every page shows the remaining days. After that Kontris is locked until a license is installed. The data stays.
To try things out you can load a demo data set. Set DEMO_MODE=true in contracthub.env and restart the container. The data lives in the folder “Demo” and disappears again with DEMO_MODE=false.
Installing the license
The license is a single line of text starting with CHL2.. It is valid for the address of your installation (APP_BASE_URL).
- As an admin, open
https://<your-address>/admin/license. The lock screen and the license notices link to the page as well. - Paste the text and click Install license. Line breaks from the email do not matter.
It also works on the command line:
docker compose exec contracthub node dist/license.js install 'CHL2.…'
docker compose exec contracthub node dist/license.js status
What to know about the license
- Expiry: From 30 days before the end, admins see a notice and receive mails. After the end there is a grace period, then the lock. With a new license everything works again right away.
- Number of users: If the license has a limit, all active users count. Once it is reached, no further users can be created.
- Locked does not mean lost: Even without a valid license admins can sign in, install the license and create or restore backups.
Next steps
- Set up mail so that reminders arrive
- Single sign-on via Entra ID or Authentik
- Switch on the backup
As of 2026-11-15 · Stuck? Write to us