mlab docs

Quick start

Deploy the full platform, then build your first DORA register in minutes.

Prerequisites

  • Docker and Docker Compose on the host (Linux server, VPS or local machine).
  • A license key. A free key is auto-created with your mlab.sh account - find it on mlab.sh/orga/tprm/license.
  • 2 GB RAM and 10 GB disk minimum.

Deploy

# Create project directory
mkdir tprm-mlab && cd tprm-mlab

# Download config files
curl -O https://mlab.sh/assets/internals/tprm.mlab.sh/docker-compose.yml
curl -o .env https://mlab.sh/assets/internals/tprm.mlab.sh/.env.example

# Edit .env: paste your LICENSE_KEY, set strong passwords,
# and optionally ADMIN_INITIAL_PASSWORD (12+ characters)
nano .env

# Launch
docker compose up -d

Open http://localhost:8080. Database migrations (V1 -> V46) run automatically on first boot.

First login

The first start creates the administrator admin@localhost and a default organisation. There is no default password:

  • With ADMIN_INITIAL_PASSWORD set in .env (12 characters or more), sign in with it.

  • Without it, the logs print a one-time setup link, valid 72 hours:

    docker compose logs app | grep "Admin setup"
    # Admin setup (admin@localhost), valid 72h, open once: /auth/reset?k=...

    Open http://localhost:8080/auth/reset?k=... and choose the password. Until a password is set, each restart prints a fresh link.

Upgrading from 1.5.x or older? An administrator still on the old public password adminadmin is locked at start-up, and a setup link is printed in the logs to choose a new one.

Your first register, step by step

  1. Name your organisation and invite teammates under Organization (/orga/team/settings). Free allows up to 3 users. To sign in with Microsoft Entra ID, Okta or Google, set up single sign-on.
  2. Set the reporting entity (B_01.01) under /ei/ - LEI, name, country and entity type.
  3. Add your first provider under /tp/ with category, criticality, LEI and country of head office (B_05.01).
  4. Attach a contract under /ct/ with a unique contract reference (feeds B_02.01 / B_02.02).
  5. Run a risk assessment under /ra/ to score the provider across five dimensions.
  6. Generate the register under /reg/, then Validate and export the 15 EBA templates from /eba/ (Licensed).

Verify it's running

docker compose ps
docker compose logs app | grep -E "Migrations completed|migration V"

The app answers on http://localhost:8080 and redirects to /auth/login. The migration log line confirms the schema was applied on boot.

Next steps

On this page