Review Server & Static UI
mixbox.review_server is a FastAPI server that serves a pre-built static UI plus a WebSocket review API.
Surfaces
| Surface | Serves |
|---|---|
| Static UI | Pre-built assets from the supplied --dist-dir |
| WebSocket API | The review runtime |
Local vs Deployment
| Aspect | Local | Code default (review_server.py) | Live host (mxbx.service) |
|---|---|---|---|
| dist dir | Mandatory explicit --dist-dir <existing-built-ui> pointing at your own built UI | /home/dev/audio/mixbox/user/opendaw-test/dist — outside this repository tree | MIXBOX_REVIEW_DIST_DIR=/home/loca/dev/mixbox/dist-placeholder, a placeholder stub rather than a real built UI |
| bind | 127.0.0.1:<free-port> | host 0.0.0.0, port 55644 | 127.0.0.1:51644 — loopback only, set through MIXBOX_REVIEW_HOST and MIXBOX_REVIEW_PORT |
| source root | MIXBOX_REVIEW_INPUT_FOLDER if set, else paths.input_folder from config.yaml | Same resolution order, no built-in path | /home/loca/dev/mixbox/tunes |
| public entry | None | None | https://mxbx.loca.zone, behind Authelia SSO (one_factor policy) |
| portable | Yes | No — the default dist path exists on no current host | No — host-specific unit at /etc/systemd/system/mxbx.service |
deploy/systemd/mixbox-review.service | Not used | Its environment repeats these same literals | Not live configuration — a historical artifact for the retired 0rk.de host |
uv run python -m mixbox.review_server --dist-dir <existing-built-ui> --host 127.0.0.1 --port <free-port>Code defaults are not deployed values
The server cannot start if the supplied
--dist-dirdoes not exist, the checked-in default points outside this tree, and the live unit overrides host, port, and dist dir through environment variables.