Self-Hosted Installation
Get MinusX running with Docker in 5 minutes
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, see the development setup guide.
1. Clone the repo
git clone https://github.com/minusxai/minusx.git
cd minusx2. Configure environment variables
MinusX is a single Next.js app — the AI agent orchestrator runs in-process, so
all configuration lives in frontend/.env (there is no separate backend).
cp frontend/.env.example frontend/.envEdit frontend/.env — add your Anthropic key and a generated NextAuth secret:
# LLM provider for the in-process agent orchestrator
ANTHROPIC_API_KEY=<your-anthropic-key>
# Generate with: openssl rand -base64 32
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.duckdb4. Start MinusX
docker compose up -dMinusX will be available at http://localhost:3000.