Web UI

Web UI & APIs

[http]
enabled = true
port = 8787
token = "long-random-string"
web = true
username = "you"
password = "strong-passphrase"

• Chat in the browser at http://localhost:8787. Basic auth is required: no credentials, no UI, on purpose.
• HTTP API: POST /run with {"prompt":"..."} returns {"reply":"...","media":[]}. Send the bearer token.
• Health check: GET /health returns {"ok":true}, handy for a monitor or a container probe. It needs the token too.
• Webhooks: POST /hook/NAME. Point your server monitor, CI or doorbell at it; the body becomes an event phoenix reacts to.
• WebSocket: connect to /ws, send {"prompt":"..."} frames, get {"reply":"..."} back. Build your own client in an afternoon.
• Canvas: phoenix can render pages and dashboards at /canvas.

Quick check with curl:

curl -H "Authorization: Bearer YOUR_TOKEN" http://localhost:8787/health
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
     -d '{"prompt":"say hello"}' http://localhost:8787/run

Expose it to the internet only behind HTTPS (reverse proxy), with the token and password set. Security has the checklist.