Beta setup
Set up Tailscale for Buildpick
The Buildpick iPhone app reaches the server on your Mac through Tailscale, a private network between your own devices. This page covers steps 3 and 4 of the beta invite. Tailscale is free for personal use. Each step links to Tailscale's own documentation for detail.
Prefer a guided setup? Paste this into Claude Code on your Mac.
Show the prompt
Guide me through the Tailscale setup for the Buildpick Mac app, one step at a time. Rules: run only read-only commands. Before each command that changes state (`tailscale up`, `tailscale serve`), show it and wait for my yes. If `tailscale` is not on PATH, use the CLI path found in step 1 for every command. Never use `tailscale funnel`. Keep each message short. Step 0, check what is done. Run these on this Mac and report what is done and what is missing: 1. Find the CLI: `which tailscale || ls /Applications/Tailscale.app/Contents/MacOS/Tailscale /opt/homebrew/bin/tailscale /usr/local/bin/tailscale` 2. `tailscale status --json --peers=false`: BackendState must be "Running". Read Self.DNSName (my Mac's .ts.net name), CurrentTailnet.Name, MagicDNSSuffix (non-empty means MagicDNS is on) and CertDomains (non-empty means HTTPS certificates are enabled). 3. `curl -s http://127.0.0.1:13220/api/health`: the Buildpick Beta server must answer. 4. `tailscale serve status`: does it already map port 13220 to http://127.0.0.1:13220? Then guide each missing step, waiting for my confirmation and re-checking after each: - Install Tailscale on the Mac and the iPhone, signed in to the same account: https://tailscale.com/docs/install/mac and https://tailscale.com/docs/install/ios (I do this and confirm). - In the admin console DNS page (https://login.tailscale.com/admin/dns), turn on MagicDNS and HTTPS certificates. Warn me first that turning on HTTPS certificates publishes my Mac's name and my tailnet name in public certificate logs, and that I can rename the Mac in the admin console first. Tell me what to click: https://tailscale.com/docs/features/magicdns and https://tailscale.com/docs/how-to/set-up-https-certificates. I confirm, you re-check. - Publish the server. The exact command is `tailscale serve --bg --https=13220 http://127.0.0.1:13220` (the port is the one in Buildpick Mac app > Settings > Pairing; use that port if it differs from 13220). Ask me, then run it, then check `tailscale serve status`. - iPhone: Tailscale app connected, same account. I confirm. Finish by giving me the iPhone server address, https://<Self.DNSName>:13220 (lowercase, no trailing dot), to paste in the Buildpick iPhone app under Settings > Servers > Add Server. Then tell me to click "Pair Another Device" in the Mac app, Settings > Pairing.
1. Install Tailscale on the Mac and the iPhone
Install Tailscale on both devices and sign in to the same Tailscale account on each. See Install Tailscale on macOS and Install Tailscale on iOS.
You should see: Tailscale connected on both devices, and both listed in the Machines page of the admin console.
2. Turn on MagicDNS and HTTPS certificates
Open the DNS page of the Tailscale admin console. Make sure MagicDNS is on, then enable HTTPS certificates. Read MagicDNS and HTTPS certificates for what each does.
Turning on HTTPS certificates publishes your Mac's name and your tailnet name (such as tail1234.ts.net) in public certificate logs. Rename the Mac in the Tailscale admin console first if its name says something you would rather keep private.
You should see: MagicDNS enabled, and HTTPS certificates enabled, on the DNS page. Your Mac
gets a name that ends in .ts.net.
3. Publish the server with the command the Mac app shows
In the Buildpick Mac app, open Settings (Cmd+,), pick your server, then open Pairing. Copy the command in the box (the Copy command button does it) and run it once in Terminal. It looks like this, with your server's port number:
tailscale serve --bg --https=PORT http://127.0.0.1:PORT This is tailscale serve, not tailscale funnel. It makes the server
on your Mac, which listens only on 127.0.0.1, answer over HTTPS to the devices on your
tailnet. It does not open anything to the public internet. See tailscale serve for the options.
You should see: the command finishes and prints the tailnet address it serves. If the Mac app says "Tailscale is not running on this Mac", install it, sign in, then reopen Settings.
4. Copy the iPhone server address
Back in Settings > Pairing on the Mac, copy the address under "iPhone server address" (the
Copy address button does it). It looks like https://your-mac.your-tailnet.ts.net:PORT. On the iPhone, in the
Buildpick app, go to Settings (gear) > Servers > Add Server and paste it.
You should see: the new server in the Servers list. Then click "Pair Another Device" on the Mac and type the 6-digit code on the iPhone within 5 minutes.
5. Check that the iPhone reaches the Mac
Open the Tailscale app on the iPhone and confirm it is connected. Both devices must show as connected in the Machines page. Keep the Buildpick Mac app running.
You should see: the server online in the iPhone app, with no "Offline" label.
Common problems
The app shows "Offline"
Check that Tailscale is on in both devices and that the Buildpick Mac app is running. Then run the command from step 3 again if the Mac was restarted or Tailscale was reinstalled, and confirm the address on the iPhone matches the one in Pairing.
A certificate error
This usually means HTTPS certificates are not enabled yet. Do step 2, then try again. The first connection can take a few seconds while Tailscale requests the certificate.
The Mac shows no address
The Mac app shows the address only while Tailscale is running and signed in on the Mac. Open Tailscale, sign in, and reopen Settings.
The devices use different Tailscale accounts
The two devices must be on the same tailnet. Sign out of Tailscale on one device and sign in with the account the other uses. To use two accounts on purpose, see inviting users to your tailnet.
Tailscale is a registered trademark of Tailscale Inc. Buildpick is not affiliated with Tailscale.