Skip to content

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. Open Settings and choose Sync (or choose Synced in the app menu).
  2. Under Devices, click Add a device.
  3. 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.

  1. Open Settings and choose Sync.
  2. In Sync server, type the same server address as your other devices, for example https://sync.example.com/v2.
  3. Click I have another device.
  4. Type the code shown on the other device, then click Join.
  5. Compass says Confirm on the other device. Go on with step 3 below.

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.

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.

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.
  • “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.