> ## Documentation Index > Fetch the complete documentation index at: https://docs.lusor.ai/llms.txt > Use this file to discover all available pages before exploring further. # Connect your iPhone > Set up your own iPhone with the Lusor Mac app, step by step, so agents can use it. When you finish these steps, your iPhone shows on the **Phones** page as your own phone, and agents in your workspace can use it. Your iPhone connects through the Lusor Mac app. The app installs a small driver on the iPhone, called Lusor Link, that lets agents see the screen and tap, type and swipe. The setup takes a few minutes, most of it while the driver installs. ## Requirements * **A Mac with Apple silicon.** The Lusor Mac app does not run on Intel Macs. * **macOS that can run the current Xcode** from the Mac App Store. * **Full Xcode, not just Command Line Tools.** Install Xcode from the Mac App Store (about 15 GB), open it once and accept the license. Lusor uses Xcode to sign and install its driver. Xcode also needs its iOS component. If it is missing, Lusor offers to install it during setup. * **An Apple ID signed in to Xcode.** Either works: * A free personal Apple ID. The signing lasts 7 days, so you sign again every week. * A paid Apple Developer account. The signing lasts for the year, with no weekly reminder. Your Apple ID stays in Xcode and is never sent to Lusor. * **A USB cable that carries data**, for the first connection. After that, the iPhone can connect over Wi-Fi. * **An iPhone with Developer Mode**, which means iOS 16 or later, and its passcode. * **A free phone slot on your plan.** Your iPhone uses one slot. See [Plans and credits](https://docs.lusor.ai/help/plans-and-credits.md). ## Install the Mac app and sign in 1. [Install the Lusor Mac app](https://docs.lusor.ai/help/install-the-mac-app.md) and open it. 2. On **Sign in to Lusor**, choose **Continue in browser**, then sign in or create an account in your browser. 3. If Lusor asks **Which organization?**, pick the one this iPhone is for. 4. On **Which workspace?**, pick the workspace the iPhone should join, then choose **Continue**. 5. On **Now pair your iPhone**, choose **Pair my iPhone**. ## Plug in your iPhone 1. Unlock your iPhone and connect it to the Mac with the USB cable. 2. On **Connect your iPhone**, choose **Next**. Keep the iPhone unlocked until setup finishes. Connect only the iPhone you want to set up. To add more iPhones later, see [Add another iPhone](#add-another-iphone). ## Trust This Computer 1. On the iPhone, the **Trust This Computer?** alert appears. Tap **Trust**. 2. Enter your iPhone passcode. 3. On the Mac, choose **Detect my iPhone**. If the alert does not appear, unplug the iPhone, plug it back in and unlock it. ## Turn on Developer Mode 1. On the iPhone, open **Settings** → **Privacy & Security** → **Developer Mode**. 2. Turn **Developer Mode** on. 3. iOS asks you to restart. Tap **Restart**. 4. After the iPhone restarts, unlock it. iOS asks whether to turn on Developer Mode. Tap **Turn On**, then enter your passcode. 5. Keep the iPhone unlocked and connected. On the Mac, choose **Check my settings**. > [!TIP] > > If **Developer Mode** is not in **Privacy & Security**, keep the iPhone connected to the Mac and trusted, then open Settings again. ## Choose how to sign the driver On **Choose signing method**, pick the kind of Apple ID you use in Xcode: * **Personal Apple ID**: free, re-sign every 7 days. * **Apple Developer account**: annual signing, no weekly reminder. If Xcode is signed in to more than one Apple development team, Lusor asks you to **Choose the Apple team for Lusor**. ## Install the driver 1. On **Install the iPhone driver**, choose **Build and Install**. 2. Wait while Lusor signs and installs Lusor Link on the iPhone. Keep the iPhone unlocked. If Lusor shows **Install iOS support for Xcode**, choose **Install iOS support** and wait for the download to finish. It is large. Then choose **Try again**. ## Finish and see it online 1. Lusor launches the driver and adds the iPhone to your workspace. You see **Adding to your workspace** while this happens. 2. When you see **Connected to** *your workspace*, setup is done. Choose **Explore Lusor**. You can now unplug the cable. Your iPhone keeps working over Wi-Fi while it is on the same network as the Mac. ## Keep the iPhone ready for long sessions * **Keep the Mac on and online, with Lusor open.** Agents reach your iPhone through the Mac app. * **Keep the iPhone unlocked.** When the iPhone locks, automation pauses and Lusor shows **Unlock your iPhone**. Unlock it, enter the passcode, then choose **Reconnect**. * **Keep the iPhone on the same Wi-Fi network as the Mac**, or connected with the cable. * **Pause instead of unplugging.** To keep agents off the iPhone for a while, choose **Pause iPhone** in the Lusor menu bar menu. ## Check it works 1. Open the **Phones** page at [app.lusor.ai](https://app.lusor.ai). Your iPhone is listed, and under its screen it says **No agent on this phone** rather than **Offline**. 2. In the Lusor menu bar menu, the status reads **Connected iPhones: 1**, followed by the iPhone's name. 3. Start a chat on the iPhone and send a short task. See [Your first task](https://docs.lusor.ai/help/your-first-task.md). ## Troubleshooting > [accordion] No iPhone detected > > Connect an unlocked iPhone with a USB cable, tap **Trust** on the iPhone, and keep it unlocked while Lusor detects it. Then choose **Try Again**. > > If Lusor says **No iPhone is connected**, it remembers an iPhone from an earlier setup that it cannot reach now. Connect the iPhone you want to set up with a USB cable, unlock it and choose **Try Again**. > [accordion] Trust this Mac > > The iPhone has not trusted this Mac yet. Unlock the iPhone, tap **Trust** when asked whether to trust this computer, and enter the passcode. If the prompt does not appear, unplug and reconnect the iPhone, then choose **Check Again**. > [accordion] Turn on Developer Mode, or Could not verify Developer Mode > > Open **Settings** → **Privacy & Security** → **Developer Mode** on the iPhone and turn it on. Restart the iPhone, confirm Developer Mode after the restart, then choose **Check Again** with the iPhone unlocked and connected. > [accordion] Xcode isn't ready, or Full Xcode required > > Command Line Tools alone are not enough. They do not include the iOS SDK Lusor needs. Choose **Get Xcode** to open Xcode in the Mac App Store. Install it, open it once, accept the license, then choose **Try again**. > [accordion] Create a new Apple Development certificate > > Your Apple account has a development certificate for this Mac, but its private key is not on this Mac. This happens on a new, reinstalled or cleaned-up Mac. > > 1. Choose **Open Xcode**. > 2. In Xcode, open **Settings** → **Accounts**, select your Apple ID and choose **Manage Certificates**. > 3. Add an **Apple Development** certificate. Accept **Revoke** if Xcode asks. > 4. Back in Lusor, choose **Try again**. > [accordion] Refresh your provisioning profiles > > Xcode is using a provisioning profile that no longer exists. Open Xcode → **Settings** → **Accounts**, select your Apple ID and team, choose **Download Manual Profiles**, then choose **Try again** in Lusor. > [accordion] Add your Apple ID to Xcode, or Apple ID signing needs attention > > Xcode has no Apple ID it can use to sign the driver. Choose **Open Xcode**, go to **Settings** → **Accounts**, sign in with your Apple ID and confirm the development team. Then choose **Try again**. > > If Lusor says **Choose one Apple ID in Xcode**, Xcode is signed in to more than one development team. In Xcode, choose **Settings** → **Accounts**, keep only the Apple ID you want Lusor to use, then choose **Try again**. If Lusor instead shows **Choose the Apple team for Lusor** with a list of teams, pick the team there. > [accordion] Build or install failed > > Lusor could not finish installing the driver. Keep the iPhone unlocked and connected, then choose **Build and Install** again. If it repeats, open **Diagnose**, copy the technical detail and send it to [support@lusor.ai](mailto:support@lusor.ai). > [accordion] Driver did not connect > > The driver launched, but Lusor did not get a working connection within two minutes. Keep the iPhone unlocked and on the same network as the Mac, then choose **Reconnect**. > [accordion] Added by another user, or Enrolled to another workspace > > **Added by another user** means someone else in your workspace added this iPhone. It reconnects when that person signs in to Lusor on this Mac. > > **Enrolled to another workspace** means the iPhone belongs to a different workspace than the one you are signed in to. Nothing was moved. Switch to the iPhone's workspace, or move it with **Move this iPhone to this workspace**. > [accordion] Couldn't add it to your workspace > > The iPhone is set up on the Mac, but Lusor could not add it to your workspace. Choose **Try reconnecting**. Nothing is undone and you do not need to reinstall the driver. > > If the iPhone shows **Not added · over your plan**, your plan has no free phone slot. Upgrade your plan, or remove another phone, then try again. > [accordion] Start setup over > > **Start setup over** disconnects the iPhone from Lusor and runs setup again. The iPhone stays paired with the Mac and you stay signed in. Running setup again takes a few minutes. > > If the iPhone was set up by another Lusor user or account, Lusor changes nothing. Sign in as that user first, or move the iPhone to your workspace instead. When more than one iPhone is set up on the Mac, this button is called **Remove this iPhone**. ## Add another iPhone 1. In the Lusor menu bar menu, choose **Find iPhones…**. 2. Connect and unlock the new iPhone. 3. Choose **Set up** next to it, then follow the same steps from [Trust This Computer](#trust-this-computer). ## Known limits * **Free Apple ID signing lasts 7 days.** Lusor reminds you about 48 hours before it expires. When it expires, the driver stops launching until you open Lusor and sign again. A paid Apple Developer account avoids the weekly renewal. * **Your Mac has to stay on.** Agents cannot reach the iPhone while the Mac is asleep, offline, or Lusor is closed. * **The iPhone has to stay unlocked** for automation to run. * **Internet and location settings do not apply.** Your iPhone uses its own connection. Those settings are for [Lusor Phones](https://docs.lusor.ai/help/lusor-phones.md). * **It does not use Lusor Phone minutes.** Agent time on your own iPhone uses credits for the AI work but no Lusor Phone minutes. To remove your iPhone from Lusor, see [Remove a phone](https://docs.lusor.ai/help/lusor-phones.md#remove-a-phone). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.