Skip to content

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)

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