Skip to content

Pair your phone

Pairing links one phone straight to one computer. You don’t need it if you signed in and ran remotxai up, and it only works when the computer’s daemon runs with REMX_LEGACY_PAIRING=1, because new pairing is off by default. Do it once per phone, with the computer’s terminal and the phone’s app open.

Pairing has ended on computers that use the remotxai relay, and the app at app.remotxai.com no longer offers it. There, sign in to the app instead: the computer shows up under your organisation, and a phone that was paired before shows Sign in when it tries to connect. The steps below are for a computer on a self-hosted relay or on your local network only.

On iPhone, add the app to your home screen first and pair from there. It doesn’t share data with Safari.

  1. On the computer, run remotxai pair and leave it open.

  2. In a second terminal on the computer, run remotxai pair setup. It prints a QR code and two links.

  3. On the phone, open the app address the computer printed when remotxai started and choose Scan pairing QR. Point the camera at the QR code.

    Pairing screen with a Scan pairing QR button and a link to paste the pairing link instead.Pairing screen with a Scan pairing QR button and a link to paste the pairing link instead.
    Tap Scan pairing QR and point the camera at the code on your computer.
  4. No camera? Choose Can’t scan? Paste the pairing link instead and paste the first link.

    Pairing screen after pasting a link, showing the verified computer and the connect button.Pairing screen after pasting a link, showing the verified computer and the connect button.
    No camera? Paste the pairing link and check that the computer shows as verified.
  5. The phone shows a 10-character Verification code, such as 8K4ZN-W2PXE. Type it at the pair ▸ prompt in the first terminal. You have 3 minutes.

  6. Answer the terminal prompts: scope (a for all sessions, l for the session list only), y to confirm, a role, then an optional phone name.

The phone then shows your sessions.

Home screen of the paired computer with the new session form.Home screen of the paired computer with the new session form.
Your computer is paired. Start a session from here.

A phone pairs with a computer for the first time only from its QR code or its pairing link, which carry the computer’s whole key. Typing a session code reaches only a computer the phone already paired with.

Role What the phone can do Key
Viewer Watch sessions. Nothing else. v
Approver Watch and answer approvals. p
Driver Watch, send prompts and start sessions. d
Admin Everything, including changing settings. m

Enter alone picks Viewer. Give each phone the smallest role it needs; your own usually gets Driver or Admin.

Run remotxai pair for each new phone. remotxai pair list shows paired phones. To remove one, run remotxai pair revoke with the start of its fingerprint.

Next: start your first session.