Skip to content
Paulus1337 edited this page Jul 27, 2026 · 3 revisions

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 required — no credentials, no UI, on purpose).
  • HTTP API: POST /run with {"prompt":"…"}{"reply":"…"} (Bearer token).
  • 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/dashboards at /canvas.

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

Clone this wiki locally