INSTALL — Mastermind MVP

Prerequisites

Docker + Docker Compose (recommended)
A stable hostname/IP you can reach (LAN or Tailscale)

Configure

cd /path/to/mastermind-mvp
cp .env.example .env

Edit .env:

SESSION_SECRET — set to a long random value
BASE_URL — the URL you use to reach the app (Tailscale IP recommended)
BOOTSTRAP_OWNER_EMAIL / BOOTSTRAP_OWNER_PASSWORD — one-time local owner login created only when no local identities exist
- Defaults in .env.example are set for local MVP use: owner@local / owner

OAuth is optional for now:

GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET
MICROSOFT_CLIENT_ID/MICROSOFT_CLIENT_SECRET

Start (Docker Compose)

docker compose up -d --build

App:

http://<BASE_URL_HOST>:3005/login
With the default .env.example, that is http://localhost:3005/login

On first run, if no local identities exist, the app creates the bootstrap local owner from:

BOOTSTRAP_OWNER_EMAIL
BOOTSTRAP_OWNER_PASSWORD

Immediately change that password:

http://:3005/account/password

Create your first project

http://:3005/projects

Import email (until OAuth is connected)

Export emails as .eml and upload:

http://:3005/inbox

Enable connector placeholders

http://:3005/admin/email

Connectors will show Configured: no until OAuth client credentials are added.

OAuth callbacks (when you’re ready)

These are the callback URLs the app expects:

Google: BASE_URL/auth/google/callback
Microsoft: BASE_URL/auth/microsoft/callback

Set BASE_URL correctly before authorizing.

Test

npm test

Direct Node.js run (no Docker, memory DB)

Install dependencies:

npm ci --prefix web
npm ci --prefix worker

Terminal 1:

cd /path/to/mastermind-mvp
export DATABASE_URL=memory://local
export SESSION_SECRET='replace-with-a-long-random-string'
export BASE_URL='http://localhost:3005'
export BOOTSTRAP_OWNER_EMAIL='owner@local'
export BOOTSTRAP_OWNER_PASSWORD='ChangeMe12345'
npm run start:web

Terminal 2:

cd /path/to/mastermind-mvp
export DATABASE_URL=memory://local
npm run start:worker

2.2 KiB Raw Blame History Unescape Escape