Self-Hosted Installation

MinusX is currently in alpha. Expect rough edges, breaking changes, and incomplete features. We'd love your feedback — open an issue or reach out to the team.

Prerequisites

Docker and Docker Compose
An Anthropic API key

For local development without Docker (running frontend and backend directly), see the development setup guide.

1. Clone the repo

git clone https://github.com/minusxai/minusx.git
cd minusx

2. Configure environment variables

Backend — create backend/.env:

cp backend/.env.example backend/.env

Edit backend/.env and add your Anthropic key:

ANTHROPIC_API_KEY=<your-anthropic-key>

Frontend — create frontend/.env:

cp frontend/.env.example frontend/.env

Generate a NextAuth secret and add it to frontend/.env:

# Generate the secret
openssl rand -base64 32

# Add to frontend/.env
NEXTAUTH_SECRET=<generated-secret-here>

3. Download sample data

Download the mxfood demo dataset (~140MB) — a food delivery analytics database:

mkdir -p data
curl -L -o data/mxfood.duckdb https://github.com/minusxai/sample_datasets/releases/download/v1.0/mxfood.duckdb

4. Start MinusX

docker-compose up -d --build

MinusX will be available at http://localhost:3000.