All articles · 06 Phone
  1. 01Getting started
  2. 02Permissions
  3. 03Agents & runtimes
  4. 04Answering
  5. 05Voice & Talk
  6. 06Phone
  7. 07Machines & servers
  8. 08Notifications & sounds
  9. 09License & billing
  10. 10Privacy & security
  11. 11Troubleshooting
  12. 12Uninstall
Help · 06

Your phone

Answer your agents from your iPhone, on Wi‑Fi or cellular. No app store, no port forwarding, no tailnet required.

2 min read · Updated 8 October 2026

How it works#

The phone app is a web app on onestation.dev that you add to your Home Screen. It reaches your Mac through the onestation relay, end-to-end encrypted: the relay forwards sealed messages it cannot read. Your Mac needs to be on, online and running onestation with an active trial or license.

Pair a phone#

  1. Show the code on your Mac

    In onestation, open SettingsPhone & devices (G then S). The QR code works once and expires in 10 minutes. New code makes a fresh one.

  2. Scan it with the iPhone camera

    Open the link. The phone shows “Compare this code on your Mac” and a six-digit code.

  3. Allow this phone on your Mac

    Your Mac shows Allow this device? with a code. Compare all six digits. Click Allow only if both codes match; otherwise click Deny.

  4. Add to Home Screen

    In Safari, tap Share › Add to Home Screen. Open onestation from there from now on.

Why compare codes

The six digits prove that the phone you are allowing is the one that scanned your code. Names shown on the Mac are supplied by the phone, so trust the digits, not the name.

What you can do on the phone#

Answer questions (including multiple choice), type replies, message any agent, interrupt, start a configured project, and kill an agent after confirming. The same two-second undo applies.

The onestation phone app: an Inbox of agent questions with numbered options.
The Inbox on iPhone.

The phone app doesn’t send push notifications yet. Open it from your Home Screen to see what is waiting.

Offline states#

The phone showsWhat it means
Live · your MacConnected. Answers go through right away.
Reconnecting…The connection dropped and is being restored. Wait a moment.
Mac offline — last updated 14:32Your Mac is asleep, offline or onestation isn’t running. You see the last state, but answering is paused. Nothing is queued.
Mac offline — outcome unknownThe connection dropped while sending. Refresh and check the card before sending again.

The phone never resends an answer by itself, so nothing is delivered twice.

More than one Mac#

Pair the same phone with each Mac. Each pairing has its own keys, and the phone app lets you switch between them. Each Mac can pair up to 10 phones; one license covers 2 Macs.

Revoke a phone#

SettingsPhone & devices, then Revoke next to the phone. It is disconnected within seconds and must pair again to come back. Do this right away for a lost phone.

Clearing Safari’s website data for onestation.dev also removes the pairing on that phone; pair again afterwards.

Still stuck?Email us with what you tried. A person reads every message, usually within one working day (CET).

Email support