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
  1. Open the address and sign in under Local account with admin and the one-time password.
  2. Set a new password.
  3. 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).

  1. As an admin, open https://<your-address>/admin/license. The lock screen and the license notices link to the page as well.
  2. 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

As of 2026-11-15 · Stuck? Write to us