Pair your phone

The DeepSeekBot phone app connects to DeepSeek Harness (DSH) on your own computer. Bots, chat history and approvals stay on the computer; the phone is a remote client.

Without an account, the phone reaches the computer through Tailscale: the phone and the computer sign in to the same Tailscale network (tailnet), the computer publishes DSH as https://<computer>.<tailnet>.ts.net with tailscale serve, and after you scan the code the phone connects back through that address. You need no public IP and no router changes, and it works over mobile data. If you would rather not set up Tailscale, use DeepSeekBot Connect instead.

The whole setup takes about 10 minutes:

1. Install Tailscale on the phone and the computer, and sign in with the same account.
2. Start DSH with the DeepSeekBot plugin on the computer.
3. Run the tailscale serve command shown in settings on the computer.
4. Show a pairing QR code on the computer and scan it with the phone app.

#1. Install and sign in to Tailscale

Tailscale is free for personal use. Install it on both the phone and the computer:

Sign in on both devices with the same account (Google, Microsoft, GitHub, Apple and others work) and keep the switch connected. The first time you open it on the phone, the system asks to add a VPN configuration; allow it.

Then open the DNS page of the Tailscale admin console and check that MagicDNS and HTTPS Certificates are both on. The phone only accepts an HTTPS *.ts.net address, so it cannot connect without HTTPS certificates.

#2. Start DSH and DeepSeekBot on the computer

Start the DeepSeek Harness desktop app (or dsh web) and check that the DeepSeekBot plugin is installed and enabled: Bot mode shows in the left bar. If it is not installed yet, follow Install DeepSeekBot first.

Open Bot mode, click the gear at the bottom left to open Bot settings, and choose Devices.

If the page only shows the Pair a phone button, as above, Tailscale is ready: skip to step 4.

#3. Publish DSH on your tailnet

When Tailscale is missing or not publishing DSH yet, the Devices page shows a yellow notice with a command, for example:

Open a terminal on the computer and run the command exactly as shown (your port may differ):

tailscale serve --bg 3080

• --bg keeps it running in the background, including after you close the terminal or restart the computer.
• On macOS, if the tailscale command is not found, use the full path: /Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 3080.
• If the first run prints a link saying HTTPS is not enabled for your tailnet, open it, enable HTTPS, and run the command again.

The command publishes DSH only to devices in your own tailnet; it is not reachable from the internet. Close and reopen the Devices page: once the yellow notice is gone, continue.

#4. Show the pairing code and pair the phone

On the computer, click Pair a phone on the Devices page. A QR code opens:

The code works once and expires after 10 minutes. If it expires, click New code.

On the phone:

1. Check that the Tailscale app is connected.
2. Open the DeepSeekBot app. On first launch it opens Pair with your computer. If you already paired another computer, open Workspaces → Computers → Pair a new computer.
3. Allow the camera and point it at the code on the computer. If scanning does not work, click Copy pairing link on the computer, send the link to your phone (for example through your own notes or chat), and paste it into Or paste the pairing link.
4. Optionally give the phone a name under Name on this phone, then tap Pair.

Once paired, the phone shows the Bots and groups on your computer, and the computer's Devices page lists the phone under Paired devices with its last-seen time. Restarting the computer or DSH does not require pairing again.

#Without Tailscale: DeepSeekBot Connect

DeepSeekBot Connect lets the phone reach the computer through an encrypted tunnel at https://<id>.deepseekbot.dev instead of Tailscale. You sign in to the same DeepSeekBot account on both devices, with Google, Apple or a code sent to your email. The tunnel exposes only the phone interface of DSH; your Bots and conversations stay on the computer.

1. On the computer, open Devices → DeepSeekBot Connect, click Sign in, and confirm in the browser that the page shows the same code. The section then shows the Connect address as Connected. One account can link up to five computers.
2. On the phone, open the pairing screen (Pair with your computer). Under Or use your DeepSeekBot account, tap Sign in and sign in to the same account.
3. The phone lists the computers linked to the account. Tap Pair with <name>. No QR code is needed.

Phones paired over Tailscale keep working; a pairing QR code shown while Connect is on carries both addresses. To stop using Connect on a computer, click Sign out there: its tunnel and address are deleted. To delete the account itself, tap Delete account on the phone's pairing screen; every linked computer is signed out. The same steps are available from the CLI: deepseekbot connect-sign-in --wait, connect-status and connect-sign-out (CLI guide).

#Troubleshooting

Settings say the code only carries the local address Tailscale is not publishing DSH yet. Go back to step 3, run the tailscale serve command, then click New code.

The phone cannot reach the computer Check in order: Tailscale is connected on the phone; both devices use the same account; the computer is on and not asleep; DSH is running on the computer. Opening https://<computer>.<tailnet>.ts.net in the phone's browser tells you whether the network path works: any page the computer serves, even a DSH error page, means the phone can reach it. A browser message that the site cannot be found, the connection failed or the certificate is invalid means it cannot.

The yellow notice is back after restarting DSH If the port in the notice changed, run the new tailscale serve command it shows.

A phone is lost or no longer used Click Revoke next to it under Paired devices on the computer; the phone is cut off at once. Unpair on the phone only deletes the credential the phone keeps.

Will it work on a company or school network? Tailscale connects directly or through its own relays on most networks. If the network blocks Tailscale, use DeepSeekBot Connect, which needs only ordinary HTTPS.

#Security

• A paired phone has the same authority as you on the computer, so pair only your own devices.
• The phone keeps its credential only in the system keychain (iOS Keychain / Android Keystore); the computer keeps only its hash.
• DSH itself still listens on the local address only. Phone requests go through the DeepSeekBot device gateway and can be revoked at any time. Details: ADR-0199.