
This manual is for BOM AI v0.3.1-r2.
The idea: your phone is the screen, your computer is the brain
The phone only opens the chat page — the AI keeps running on your computer as usual.
Your computer must stay on (not sleeping) and BOM AI must be running, otherwise the phone cannot connect. Both sides need internet when you use it away from home.
Step 1 — Install Tailscale on both devices
Tailscale download links
- **Windows/macOS/Linux:** [tailscale.com/download](https://tailscale.com/download) - **Android:** Google Play - **iOS:** [App Store](https://apps.apple.com/app/tailscale/id1470499037)Install Tailscale on your computer and phone, then sign in with the same account and check both devices appear in your Tailscale device list.
Step 2 — Enable HTTPS with Serve
First confirm the chat page opens on the computer at http://127.0.0.1:8080. Then open a terminal on that computer and type:
tailscale serve --bg --https=443 http://127.0.0.1:8080
tailscale serve status
The first run may show a link to enable HTTPS for your account — follow it, then run the command again. Copy the real HTTPS URL the command prints and open it on your phone. Do not guess your computer's name, and never type localhost on the phone.
Serve shares only with devices authorized in your Tailscale network. Do not use Tailscale Funnel or open public ports as a substitute for this step.
Step 3 — Open the chat from your phone
- Android: connect Tailscale, open Chrome, paste the HTTPS URL, and send a short question.
- iPhone: connect Tailscale, open Safari, and use the same URL — the steps are identical.
Send photos from your phone
Tap attach → choose a photo or the camera from your phone's menu, check the preview, type your question, and send. Calling the camera directly from the page needs HTTPS, which Serve already provides. When the phone asks for camera or photo permission, review it and allow only what you intend.
Not working? Check this table
| Symptom | Fix |
|---|---|
| The phone will not load the page | The computer is on + BOM AI is running + the chat page opens on the computer itself |
| URL does not work | The phone is connected to Tailscale + you are using the HTTPS URL from tailscale serve status |
| Page opens but questions fail | Try the same question on the computer and read the error shown |
| Camera/photos do not work | Check the browser permission prompt and the image preview before sending |
| Very slow or drops | Check internet on both sides + make sure the computer is not sleeping |
| Still not fixed | See the FAQ page |
Stop sharing the chat page
When you are done, turn the HTTPS page off on the computer:
tailscale serve --bg --https=443 off
tailscale serve status
Check the status output again to confirm it is closed. This does not uninstall BOM AI or Tailscale.
Command reference: Tailscale Serve