Something not working?

1. Check notification permission. iOS Settings, Nodlock, Notifications. If you declined the prompt on first launch, the app still works when you open it by hand, but nothing will buzz.
2. Check the APNs environment on the Mac. A debug build straight from Xcode is sandbox. TestFlight and the App Store are production. The wrong value fails silently. Set OPG_APNS_ENV in the companion's env file and restart it.
3. Read the companion log. Failed sends are recorded there with the APNs response, which usually names the problem outright (bad key id, bad bundle id, unregistered token).
4. Open the app anyway. The unlock screen polls the panel directly, so if the prompt is still on screen you can approve it even when the notification is lost.

Re-pair whenever the address of your Mac changes: you moved from a LAN IP to a tunnel hostname, rotated the pairing token, or reinstalled the companion. The old QR encodes the old address, so a stale pairing simply cannot reach the panel.

1. On the phone, open the menu on the unlock screen and tap Unpair. That removes the host and token from the iOS Keychain and tells the Mac to drop your device token.
2. On the Mac, open the menu bar icon and choose Setup. The wizard shows a fresh QR that encodes the current address, token, and Cloudflare Access service token if you use one.
3. Scan it. If the camera is unavailable, paste the pairing link instead.
4. Trigger a prompt on the Mac to confirm the round trip.

Other common fixes

• Blank screenshot. Screen Recording was granted after the companion launched. Relaunch it and the capture starts working.
• Taps and typing do nothing. Accessibility is missing, or it was granted to an older copy of the bundle. Remove the old entry in System Settings and add the installed app.
• The companion will not start. Something else is already bound to port 8377. Run one watcher at a time.
• Want to try the flow first? Tap "Try a demo" on the pairing screen. Demo mode walks the whole approval flow without a Mac attached.