How do I access Codeman from my phone when I'm away from home?

[Ark0N]

The single most common question, on Reddit, in issues, everywhere. Parking the canonical answer here where search can find it.

[Ark0N]

Codeman binds to 127.0.0.1 by default, so nothing is reachable from other devices until you pick one of these:

Tailscale (what I use). Keep the default loopback bind and put Tailscale in front of it:

tailscale serve --bg 3000

You get an HTTPS URL at your machine's tailnet name, reachable from anywhere you're logged into Tailscale, and nothing is exposed to the public internet. The installer can walk you through this whole path (it's one of the options during install, and install.sh tailscale retrofits it onto an existing install).

LAN: bind to your network and set a password:

CODEMAN_PASSWORD=yourpassword codeman web --host 0.0.0.0

Fine for a phone on home wifi. Codeman warns loudly if you bind beyond loopback without a password. Don't ignore that warning.

Cloudflare quick tunnel: scripts/tunnel.sh start prints a random trycloudflare.com URL. Set CODEMAN_PASSWORD first; Codeman refuses to open a tunnel without one. There's a QR login flow so you don't have to type the password on your phone: scan the code, you're in.

Whichever you pick, add the page to your home screen. The mobile UI is not an afterthought: zero-lag typing, push notifications with Approve/Deny buttons, and a phone home screen showing which sessions need you.