Documentation Getting Started Pair Device

Pair Device

1 min read·Updated 30 Jul 2026

Pairing links a phone or a second machine to your Arble installation. It is what makes desktop control, mobile notifications and cross-device sessions possible.

What pairing actually grants

A pairing issues a device token scoped to that one device. The token is the only credential the desktop and mobile endpoints accept, and it grants nothing on its own — each capability still passes the permission gate.

Pair a device

SHELL
arble mobile pair

The command prints a code. Enter it in the Arble app on the device you are pairing. The exchange happens over your local network; nothing transits a third party.

Confirm it worked

SHELL
$ arble devices ls
NAME              KIND     STATUS     LAST SEEN
lori-iphone       mobile   online     just now
lori-mbp          desktop  online     just now

Revoking

Revocation takes effect on the next call. Revoke immediately if a device is lost — the token lives in that device's keychain, not in your account.

SHELL
arble devices revoke lori-iphone

Camera and microphone always prompt on the device itself, regardless of pairing or granted permissions. There is no configuration that enables silent capture.