Add a device
Once one device syncs (see Turn on sync), you add the
others with a pairing code: a short code like 7-482913 that a device
already in the chain shows. You need both devices at hand. No password, no
email, no sign-in.
The code works once and only for 5 minutes, and the device in the chain always asks you to approve the new one before it gets anything.
1. Show a code on a device that syncs
Section titled “1. Show a code on a device that syncs”- Open Settings and choose Sync (or choose Synced in the app menu).
- Under Devices, click Add a device.
- Compass shows a code, with Expires in and the time left, and a QR code for an iPhone or iPad.
Keep this page open until the new device has joined.
- Open Settings and choose Sync (or choose Synced in the app menu).
- Under Devices, click Add a device.
- Compass shows a code and a QR code, with the time left.
Keep this page open until the new device has joined.
- Open Settings and choose Sync (or choose Synced in the app menu).
- Under Devices, click Add a device.
- Compass shows a code and a QR code, with the time left.
Keep this page open until the new device has joined.
An iPhone or iPad can join a chain, but can’t add other devices to it. Show the code on a computer or an Android device instead.
- Open the menu, tap Settings, then Sync.
- Tap Add a device.
- Compass shows the code to enter on the other device.
2. Enter the code on the new device
Section titled “2. Enter the code on the new device”- Open Settings and choose Sync.
- In Sync server, type the same server address as your other devices,
for example
https://sync.example.com/v2. - Click I have another device.
- Type the code shown on the other device, then click Join.
- Compass says Confirm on the other device. Go on with step 3 below.
- Open Settings and choose Sync.
- In Sync server, type the same server address as your other devices.
- Click I have another device.
- Type the code shown on the other device, then click Join.
- Compass says Confirm on the other device. Go on with step 3 below.
- Open Settings and choose Sync.
- In Sync server, type the same server address as your other devices.
- Click I have another device.
- Type the code shown on the other device, then click Join.
- Compass says Confirm on the other device. Go on with step 3 below.
The quickest way is the QR code: point your iPhone or iPad’s Camera at the QR code on your computer’s screen and open the link. Compass opens with the server and code filled in and starts joining.
Or, by hand:
- In Compass, open Settings. Under Sync, tap Join with a Mac.
- Check Server: it must be the same address as your other devices. It starts with the Compass project’s server filled in; change it if yours is different.
- Type the code under Code from your Mac, or tap Scan QR Code.
- Tap Join. Compass shows Confirm on your Mac…
The screens say “Mac”, but a Windows or Linux computer works the same way.
- Open the menu, tap Settings, then Sync.
- In Sync server, type the same server address as your other devices.
- Under Pair with a device, type the code in Pairing code.
- Tap Join. Compass shows Approve this device on your other device.
3. Approve the new device
Section titled “3. Approve the new device”Back on the device that showed the code, Compass asks whether to add the new device, by name (for example Add MacBook Air to sync?). Check that it’s yours, then choose Allow. If you don’t recognize it, choose Deny.
On a computer, the new device then says Joined. Restart Compass to start syncing. Click Restart Compass. After the restart, your spaces, passwords and the rest arrive. On iPhone and iPad, Compass shows what it synced (for example Synced 2 profiles: Personal, Work · 5 spaces); tap Continue.
If the new computer has more than one profile, Compass asks which of your other devices’ profiles each one should sync with. See Profiles and sync.
Use the recovery code
Section titled “Use the recovery code”If you don’t have another device that syncs at hand (for example, you lost it), join with the 12-word recovery code instead:
- On a computer: in Sync, type the server address, click I have another device, then Use a recovery code. Type the 12 words in Recovery code (12 words) and click Join with the recovery code.
- On iPhone and iPad: in Join with a Mac, tap Use a recovery code and type the 12 words.
- On Android: in Sync, type the 12 words under Or use your recovery code and tap Join with recovery code.
Show your recovery code again
Section titled “Show your recovery code again”Any device that syncs can show the recovery code, so you can save it if you haven’t:
- On a computer: in Sync, under Recovery code, click Show recovery code. Compass first asks for Touch ID or your password, where your computer supports it.
- On iPhone and iPad: in Settings, tap Show Recovery Code and confirm with Face ID, Touch ID or your passcode.
If pairing doesn’t work
Section titled “If pairing doesn’t work”- “Wrong code”: a code allows a single try. Ask the other device for a new code (click Add a device again).
- “Code expired”: codes last 5 minutes. Show a new one.
- “Not added”: the other device chose Deny.
- Make sure both devices use exactly the same server address.
More messages are explained in Troubleshooting.