Quick start

About three minutes if Docker is already installed.

Need: Docker and Docker Compose only. No Node.js required for the default path — the image builds the cabinet SPA during docker compose build.

git clone https://github.com/maydi-oss/mixlink.git
cd mixlink

cp src/config/.env.example src/config/.env
# Generate secrets (run each command once):
python3 -c "import secrets; print(secrets.token_urlsafe(48))"
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

Start the stack:

docker compose -f docker/docker-compose.yml up -d --build

Open http://localhost:8080. Create the first and only account at /register. Further sign-ups are blocked (single-tenant).

Service	URL / access
App	http://localhost:8080
Postgres / Redis / Qdrant	internal to Compose (not published on host)

Developers only: to run uvicorn outside Docker, build the SPA once: cd src/modules/clients/user_platform/frontend && npm install && npm run build

Optional AI negotiator: set OPENAI_KEY in .env and restart app.

docker compose -f docker/docker-compose.yml logs -f app

Next: configuration and MCP.

Previous A2A commerce Next Configuration