Docker
- Backend image:
notebook-mlx-app/backend/Dockerfile(ML disabled by default). - Compose:
docker-compose.ymlexposes8000, persists data at/datausingBACKEND_DATA_DIR. - Healthcheck hits
/healthzto ensure the API is ready before dependents start.
Metrics & Logs
- Prometheus metrics at
/metrics, health at/healthz. - JSON logs in
<BACKEND_DATA_DIR>/app.logwith rotation.
Build & Releases
- macOS app:
cd notebook-mlx-app && pnpm run dist:mac. - Consider code signing + notarization for distribution.
- CI uploads frontend
dist/and Playwright report as artifacts.
Load Testing
- Quick baseline:
k6 run k6/load-test.js.
Data Directory
- Control with
BACKEND_DATA_DIR(defaultdata/). In production Electron builds, this is set to the OS user data directory.