Skip to content
BOM AI logoBOM AI
XM
XM

BOM AI Manual

Mobile & Remote Access

Connect your phone to your computer over Tailscale and chat from anywhere — your computer does the work.

Use BOM AI from your phone via Tailscale

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