Getting started
Pairing a phone
Pairing links a phone to your account with a single-use PIN. It takes about a minute and needs no cables or configuration files.
- 1Get a PINOn the dashboard, the empty state shows a pairing PIN. It's single-use, tied to your account, and expires after about three minutes — a fresh one is one click away.
- 2Enter it in the appOpen the app, tap Pair with PIN, and type the code. The app talks to us over the cellular network to redeem it, so a Wi-Fi captive portal can't interfere.
- 3Grant background permissionsThe app guides you through the battery and background permissions it needs to hold the tunnel with the screen off. This is the single most important step for a proxy that stays online — see Troubleshooting.
- 4Confirm it's onlineThe phone shows up on your dashboard with a green Online status, its carrier, and its current exit IP. You're ready to create a proxy credential.
Pairing over the API
Automating enrollment?
POST /api/v1/subscriptions returns a PIN to display in the app, and the device appears in GET /api/v1/subscriptions the moment the phone redeems it. See the API guide.Re-pairing and unlinking
A phone stays paired across reboots and app updates. To move a phone to a different account, unpair it first (dashboard, or DELETE /api/v1/subscriptions/{id}) — that releases its gateway port and revokes its credentials — then pair it again with a new PIN.
What the PIN does and doesn't share
The PIN only authorizes this one phone to join your account. It carries no personal data, works only on your account, and is useless once redeemed or expired.