Deployment — DocQStack Documentation

Operations

Standalone production deployment

Run DocQStack as native processes on a host: MySQL, Redis, uvicorn, Arq worker, Next.js standalone, and nginx. No Docker required.

1. Configure

cp .env.production.example .env.production — set MYSQL_HOST=127.0.0.1, REDIS_URL=redis://127.0.0.1:6379/0, domain URLs, OAuth.

2. Build

make standalone-deploy — migrations, pip install, Next.js production build.

3. Run services

API (:8000), worker (arq), frontend (:3000). Use scripts/ops/docqstack-*.service.example for systemd.

4. nginx

nginx/nginx.standalone.conf proxies to 127.0.0.1:3000 and :8000.

API — uvicorn app.main:app --host 127.0.0.1 --port 8000
Worker — arq app.workers.settings.WorkerSettings (scheduled publish, AI jobs)
Frontend — node server.js from frontend/.next/standalone

Full guide: repo docs/DEPLOYMENT.md. Docker Compose (make prod-deploy) is optional.