Mike

Open-source release containing the Mike frontend and backend.

Contents

• frontend/ - Next.js application
• backend/ - Express API, Supabase access, document processing, and migrations
• backend/migrations/000_one_shot_schema.sql - one-shot Supabase schema for fresh databases

Setup

Install dependencies:

npm install --prefix backend
npm install --prefix frontend

Create local env files from the examples:

cp backend/.env.example backend/.env
cp frontend/.env.local.example frontend/.env.local

Run backend/migrations/000_one_shot_schema.sql in the Supabase SQL editor for a fresh database.

Start the backend:

npm run dev --prefix backend

Start the frontend:

npm run dev --prefix frontend

Open http://localhost:3000.

Required Services

• Supabase Auth and Postgres
• S3-compatible object storage, such as Cloudflare R2
• At least one supported model provider key, depending on which models you enable
• LibreOffice for DOC/DOCX to PDF conversion

Checks

npm run build --prefix backend
npm run build --prefix frontend
npm run lint --prefix frontend

License

AGPL-3.0-only. See LICENSE.

Self-host with Docker

Single-host docker-compose stack. No managed services required.

Requirements

• Docker Engine 24+ with Compose v2
• ~4 GB free RAM and ~5 GB free disk for first-time image builds
• An LLM provider key (Anthropic or Google Gemini)

Bring up

git clone <this-fork>
cd mike
cp .env.example .env
./scripts/generate-secrets.sh
$EDITOR .env                   # set ANTHROPIC_API_KEY and/or GEMINI_API_KEY
docker compose up -d --build   # ~5 min first time
open http://localhost

Stack

Service	Role
caddy	Single ingress on ${MIKE_PORT:-80}, routes to everything else
postgres	Database
gotrue	Authentication (Supabase Auth, self-hosted)
postgrest	REST layer Mike's frontend uses for user_profiles
garage	S3-compatible object storage for documents
mike-backend	Express API + LibreOffice (DOCX → PDF)
mike-frontend	Next.js UI
init-db, init-garage	One-shot bootstrap; run on first boot, exit when done

Configuration

• Port: edit MIKE_PORT in .env. Changing it requires docker compose build mike-frontend because Next.js bakes URLs at build time.
• Email confirmation: off by default (GOTRUE_MAILER_AUTOCONFIRM=true). To enable, set it to false and add GOTRUE_SMTP_HOST / GOTRUE_SMTP_USER / GOTRUE_SMTP_PASS / GOTRUE_SMTP_PORT / GOTRUE_SMTP_ADMIN_EMAIL to the gotrue service env in docker-compose.yml.
• Reset everything: docker compose down -v deletes all volumes (Postgres data, Garage data, generated Garage credentials, Caddy state).

What's not included

This compose targets a single trusted host. It deliberately omits TLS, real SMTP, multi-node Garage, secrets-manager integration, and backups. See docs/superpowers/specs/2026-05-02-self-host-docker-compose-design.md for the rationale and what each upgrade path looks like.