fix connection & secure link errors
| Message | Fix |
|---|---|
| Your iPhone is locked | Unlock the phone and press Try again. |
| Waiting for you to trust this computer | Tap Trust on the phone and enter your passcode. |
| Trust was declined | Unplug, plug back in, and tap Trust this time. |
| Developer Mode is off | Settings → Privacy & Security → Developer Mode → On, then restart. |
| USB service isn't running | Unplug and replug — Linux starts it when a phone is attached. |
| Secure link needed (iOS 17+) | iOS 17 and later only talk to developer tools through a secure link (a "tunnel"). Elsewhere opens it for you; approve your computer's password prompt once per session. |
| Not paired with this computer (Wi-Fi) | Connect by USB once, then Wi-Fi works. |
Still stuck? Try another cable or USB port, restart the phone, then reconnect.