---
id: pairing
type: task
title: Pair your Mac and devices
summary: Pair an iPhone or iPad with Therbie for Mac once. Click Pair… on the Mac, check that the 6-digit codes match, and tap Allow on the device. The Mac can then show its readings, run tests and collect its History and sensor recordings, encrypted, over your local network.
section: start
url: "https://irrhuh.app/therbie/guide/pairing.html"
related: [device-link, mac-display, mac-app, privacy-security, troubleshooting]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---

# Pair your Mac and devices

Pairing links an iPhone or iPad to Therbie on your Mac, so the two can talk over your local network. You pair each device once. After that they connect by themselves whenever both are on the same network with Therbie open.

Once paired, the Mac can:

- show the device's live readings;
- start benchmarks, throttle tests and run plans on it;
- collect the device's data by itself, with no exporting, and change some of it at your request (see below).

The same pairing lets the device show the Mac's status in [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html), if the Mac shares it.

## Pair a device

1. **On the iPhone or iPad,** open Therbie and go to the **Mac** tab. On the **Mac Testing** card, turn on **Allow my Mac to run tests**. Allow Local Network access if iOS asks.
2. **On the Mac,** open Therbie and choose **Devices**. The device appears as **Not paired**.
3. **On the Mac,** click **Pair…**. The Mac shows a 6-digit code, such as **042 917**.
4. **On the device,** Therbie asks **Pair with "*your Mac's name*"?** and shows a code. If the two codes match, tap **Allow**.

The device is now **Connected**.

- **Keep Therbie on screen on the device while you pair.** The request only appears there, and it waits about a minute for your answer.
- **Already paired with a Mac of that name?** The request says so, and **Allow** replaces the old pairing.

> **Important** If the codes don't match, tap **Don't Allow**. A different code means something other than your Mac answered.

## Why compare a code?

Anyone on the same network can see that your device is there. Comparing codes makes sure the device is pairing with your Mac and nothing in between. Both screens work out the code on their own, and the codes match only when the two are talking directly. Bluetooth pairing uses the same idea.

After pairing:

- **Only your paired Macs can connect.** Other Macs on the network see **Not paired** and need your tap on the device to pair.
- **Everything is encrypted.** Readings, commands, results and data are encrypted between your Mac and the device, with fresh keys each time they connect.
- **The pairing key stays on your devices.** Each side keeps it in its Keychain, on that device only. It doesn't sync through iCloud Keychain and doesn't move to a new device when you restore a backup, so a new or restored device has to pair again.

## What the Mac collects {#history-from-your-devices}

While a device is connected, the Mac fetches its data when they connect and again every 15 minutes:

| Data | Where it appears on the Mac |
|---|---|
| Benchmark and throttle results | **Runs & Compare**, under the device |
| History and data usage | **Runs & Compare › Imported Data**, per device |
| Trips (with their routes), vibration sessions and the sound log | **Sensors** |
| Bluetooth plant sensor readings and Bluetooth survey counts | **Sensors** (**Plants**, **Bluetooth**) |

The device's card on the Devices page says when they last arrived. The Mac keeps this data until you delete it, or for the time set in **Therbie › Settings… › Storage › Keep synced data** (default **Forever**).

The Mac only reads what the device has recorded. iOS doesn't let Therbie record while it's paused, so gaps in a device's History stay gaps on the Mac too. See [History and Insights](https://irrhuh.app/therbie/guide/history-insights.html).

## What the Mac can change

From its **Sensors** page and device settings, a paired Mac can make changes on the device. They are sent the next time the device connects:

- rename or delete trips, vibration sessions and plant readings;
- organise Bluetooth plant sensors and their pots;
- change some device settings, such as the plant-sensor log interval and the Bluetooth survey.

## Remove a pairing

- **On the iPhone or iPad:** on the **Mac** tab, open **Paired Macs** on the **Mac Testing** card and tap **Remove** next to the Mac. If it's connected, it's disconnected.
- **On the Mac:** on the device's card, open **⋯** and choose **Unpair**.

Either way, the two have to pair again before they can connect, and the device's Mac Display stops showing that Mac. Results and data already on the Mac stay there until you delete them.

## If pairing doesn't work

- **"Open Therbie on the device to pair."** The device was in the background. Bring Therbie to the front and click **Pair…** again.
- **"A pairing was just declined or not answered on the device. Try again in a moment."** After **Don't Allow**, or a request nobody answered, the device ignores new requests for 30 seconds.
- **"The device didn't answer. Open Therbie on it and try again."** The request timed out. Click **Pair…** again and tap **Allow** within the minute.
- **"Another Mac is waiting to pair with this device."** Answer or let the other request time out first.
- **The device doesn't appear at all:** see [Troubleshooting](https://irrhuh.app/therbie/kb/troubleshooting.html#the-mac-doesnt-see-my-iphone-or-ipad).
