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.
-
On the computer, run
remotxai pairand leave it open. -
In a second terminal on the computer, run
remotxai pair setup. It prints a QR code and two links. -
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.


Tap Scan pairing QR and point the camera at the code on your computer. -
No camera? Choose Can’t scan? Paste the pairing link instead and paste the first link.


No camera? Paste the pairing link and check that the computer shows as verified. -
The phone shows a 10-character Verification code, such as
8K4ZN-W2PXE. Type it at thepair ▸prompt in the first terminal. You have 3 minutes. -
Answer the terminal prompts: scope (
afor all sessions,lfor the session list only),yto confirm, a role, then an optional phone name.
The phone then shows your sessions.


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.
Pick a role
Section titled “Pick a role”| 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.
Pair another phone, or remove one
Section titled “Pair another phone, or remove one”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.