Skip to main content

Use it from your phone

Open WebUI Computer serves your whole machine to any browser. Your phone is a browser. Pick the route that matches where you are:

Your situationDo this
Phone is on the same Wi-Fi as the computerRun cptr run --host 0.0.0.0, then open http://<computer-ip>:8000 on the phone
Away from homeTailscale (recommended), or Cloudflare Tunnel / ngrok for a public URL
You already run a domain and a reverse proxyReverse proxy and SSO

One thing to know before you pick: a signed-in user has full access to your files and shell, so choose a route where only you can reach the login page (details in the security model).

Same Wi-Fi​

cptr run binds to 127.0.0.1 by default, which only the computer itself can reach. Bind to all interfaces instead:

cptr run --host 0.0.0.0

Find your computer's LAN IP (macOS: System Settings → Wi-Fi → Details; or ipconfig getifaddr en0; Linux: ip addr), then open http://<computer-ip>:8000 on your phone and sign in.

Away from home​

You need a path from the internet back to your machine. Three good options:

  • Tailscale: recommended. A private network between your own devices; nothing is public, and cptr can stay on localhost.
  • Cloudflare Tunnel: a permanent public URL through Cloudflare's edge, best paired with Cloudflare Access.
  • ngrok: a public URL in one command, best paired with ngrok's built-in auth.

Already have a domain?​

If you run nginx, Caddy, or Traefik on a box you control, put cptr behind it like any other web app, including single sign-on via trusted-header auth. See Reverse proxy and SSO.

Then make it stick​

Two follow-ups everyone wants next:

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.