HTTP endpoints
For: self-hosters writing reverse proxy rules or network policies. At the end: you know every path each server answers, on which port, and whether it goes through your login, opens to anyone, or stays private.
To set up a proxy: Put it behind a reverse proxy.
The full view: wow-stats ui, port 8080 (PORT)
Section titled “The full view: wow-stats ui, port 8080 (PORT)”Your own page. Route it through your login, except the rows that say otherwise.
| Path | Route | What |
|---|---|---|
/, /app.js, /app.css, /items.js, /fonts/* |
through your login | the page and its files |
/api/config, /api/chars, /api/char, /api/journal, /api/overview, /api/timeline, /api/snapshot, /api/people, /api/loot, /api/dungeons, /api/gear, /api/analysis, /api/items, /api/plan, /api/market, /api/prices, /api/logsql, /api/* |
through your login | the page’s JSON answers (/api/plan also takes a POST) |
/model3d/*, /api/model3d, /render/<char>.<ext>, /icons/<size>/<name>.jpg |
through your login | the 3D view, the armory picture, the item icons |
/full/ |
through your login | FULL_DOOR_PATH: a redirect to /, through your login. Empty: off |
/healthz |
no login | health check: 200 ok, no login. Fine to route; probes need no credentials |
/ingest |
no login | POST from the shipper, with its own password (INGEST_PASSWORD). Route it without your page login, or the shipper can’t get through |
Extra full-view paths with several people (WOW_STATE_DIR)
Section titled “Extra full-view paths with several people (WOW_STATE_DIR)”Only on a shared install. Same port.
| Path | Route | What |
|---|---|---|
/start, /start/print, /start/media/*, /settings, /account.js, /account.css, /api/me, /api/me/status, /api/me/install-code, /api/me/settings, /api/me/*, /api/admin/hosts |
through your login | the start page, settings, and each person’s own answers |
/admin, /admin.css, /api/admin/overview |
through your login | the owner’s overview (Admin overview); 404 for anyone else |
/help, /help/, /help/help.js, /help/help.css |
through your login | the manual for friends: install steps, the page tour, connecting their AI |
/install/<code>, /privacy, /privacy/* |
no login | the install command (the single-use code is the credential) and the privacy page: no login |
The shipper’s auto-update: inside wow-stats ui, same port
Section titled “The shipper’s auto-update: inside wow-stats ui, same port”With one person or several. Route it like /ingest, without your page login: the shipper sends its upload password.
| Path | Route | What |
|---|---|---|
/install/update/shipper |
no login | GET, upload password: the shipper’s version and each file’s sha256, as JSON |
/install/update/shipper/<name> |
no login | GET, upload password: one of the shipper’s files (wow_stats.py, the installers) |
The MCP endpoint: inside wow-stats ui, port 8090 (MCP_PORT)
Section titled “The MCP endpoint: inside wow-stats ui, port 8090 (MCP_PORT)”Only when MCP_PUBLIC_URL is set. Route these to 8090 without your page login: the MCP’s own tokens protect them. Let cookies through on /authorize, /consent and /oauth/callback, or every login stops at the Approve button.
| Path | Route | What |
|---|---|---|
/mcp |
no login | the MCP endpoint (OAuth bearer token) |
/authorize, /consent, /oauth/callback |
no login | the login pages your browser opens |
/token, /register, /revoke |
no login | called by the AI client’s servers |
/.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource, /.well-known/oauth-protected-resource/mcp |
no login | discovery |
The static sites: wow-stats static, port 8080 in the container (8081 in the compose kit)
Section titled “The static sites: wow-stats static, port 8080 in the container (8081 in the compose kit)”Files only, no login, no cookie. Safe to put on the internet.
| Path | Route | What |
|---|---|---|
/, /zogzog/, /help/ |
no login | the public site, the sealed friends’ site (ZOGZOG_PATH) and the help page (with HELP_KEY_FILE) |
/healthz |
no login | health check |
/js/script.js, /api/event |
no login | only with PLAUSIBLE_DOMAIN: route these two to your Plausible, nothing else (on the full view’s name too, ahead of its login, when the ui has PLAUSIBLE_DOMAIN) |
Never route these from outside
Section titled “Never route these from outside”Internal listeners. Keep them on a private network.
| Path | Route | What |
|---|---|---|
/bundle, /bundles |
never | the static server’s upload port (UPLOAD_PORT) |
/analysis.json, /users.json, /hosts.json, /profile-characters, /publisher.json |
never | the full view’s share port (ANALYSIS_SHARE_PORT); the publisher POSTs its pass to /publisher.json |
/render, /model3d/view, /healthz |
never | the renderer, port 8083 |
/metrics, /healthz |
never | the exporter, port 9464 (LISTEN_PORT): its own health only, never Blizzard’s data |
/select/*, /insert/* |
never | VictoriaLogs, port 9428: your events, readable without a login |