Skip to content

Reach fxbot from your phone

Copy all docs

Open your own fxbot from a phone or any computer, at web.fxbot.sh, over a connection straight to it, with no Tailscale. You pair each device once, and it stays paired until you remove it.

You need the web-pairing plugin: add it from Plugins. It needs fxbot 0.8.0 or newer.

  • On an iPhone or iPad, open web.fxbot.sh in Safari, tap Share, then Add to Home Screen. Open fxbot from the Home Screen, and pair there. The Home Screen app keeps its own storage, apart from Safari’s, and Safari clears a site’s storage after seven days without a visit. A pairing made in Safari stays in Safari.
  • On Android, open web.fxbot.sh in Chrome, and tap Install app in its menu. Pair in the installed app.
  • On a computer, see Reach it from your computer.

Don’t pair in a private window: what it stores is gone when it closes. The app says so when it sees one.

  1. On your fxbot, open Settings › Web pairing, and choose Pair a device. Use the machine itself, Tailscale, or an SSH tunnel. It shows a code, such as 47-3816-0925, and a QR code.
  2. On the device, in the app, choose Pair a device, and type the code. On Android, Scan the QR code scans it instead. A laptop can open the QR code’s link. On an iPhone, type the code: the camera would open the link in Safari, not in the Home Screen app.
  3. Both screens show six digits. Check they’re the same, then tap Approve on your fxbot. If they differ, tap Deny: someone else is pairing.

The device says Paired. Tap Open: your fxbot’s own page fills the screen, with your bots, plugins, and settings.

A code works once, for 10 minutes. A wrong code ends it, so ask for a new one. Three wrong codes in 15 minutes lock pairing for 15 minutes.

  • It reconnects by itself, when you come back to the app, when the network changes, and when your fxbot restarts. A dot by its name says whether it’s connected.
  • Keep a way back. Pair a second device, such as your laptop, so a phone that loses its storage can pair again from it from anywhere. Or add a passkey there.
  • Check it’ll connect from elsewhere. Settings › Web pairing › Reachability says what your fxbot found about its network, before you leave home. If it says a network won’t connect directly, see When a device can’t connect.

The app asks the browser to keep its storage. The Devices screen says whether the browser agreed. If it didn’t, the browser may clear the pairing when space runs low, so keep a second device or a passkey.

On a VPS or a machine with no browser, open its Settings through an SSH tunnel from your computer:

Terminal window
ssh -N -L 8787:127.0.0.1:8787 <user>@<server>

Then open http://127.0.0.1:8787/settings/plugins/web-pairing on your computer, and pair from there. Close the tunnel when you’re done. The device reaches the server directly afterwards.

On your fxbot, in Settings › Web pairing › Devices, or on another paired device’s Devices screen, choose Remove. Its connection closes at once, and it can’t connect again until it pairs again.