Getting Started

Set up MindMatrix on your own infrastructure in minutes.

Prerequisites

  • Node.js 22 or later
  • PostgreSQL 17
  • npm or pnpm
  • Docker and Docker Compose (optional)

Option 1: Docker Compose (Recommended)

The fastest way to get started:

git clone git@github.com:mojoaar/mindmatrix.git
cd mindmatrix
cp .env.example .env
# Edit .env with your secrets
docker compose -f deploy/docker-compose.yml up -d

Access the app at http://localhost:3000

Option 2: Node.js with systemd

git clone git@github.com:mojoaar/mindmatrix.git /opt/mindmatrix
cd /opt/mindmatrix
cp .env.example .env
# Edit .env with your database credentials and secrets
npm ci
npm run build
# Run database migrations
npx drizzle-kit push
# Start the app
npm run start

First Steps

  1. Create your account at /register
  2. Create a workspace from the dashboard
  3. Invite team members from workspace settings
  4. Create your first note — press Cmd+K to search, Cmd+Enter to save
  5. Configure cloud sync from Settings > Sync