> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryscrolly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer setup (WDA)

> Set up WebDriverAgent on your Mac and iPhones, or switch an existing phone to WDA.

| iOS version | What you can choose |
| - | - |
| iOS 27 or later | **Native** or **WDA** |
| iOS 15 to 26 | **WDA** |
| Earlier than iOS 15 | Use an iPhone on iOS 15 or later |

Native installs nothing on the iPhone and needs no Apple Developer account. WDA uses WebDriverAgent, a driver app the Mac builds and signs with your Apple Developer team. Use WDA for X posts, Instagram Stories and Reels made from several clips.

## Prepare the Mac

**1. Open the developer setup**

In the Scrolly Mac app, choose **Set up** under **Apple developer team** on **This Mac**. You can also open **Settings › WDA & Xcode**. You need a [paid Apple Developer membership](https://developer.apple.com/programs/enroll/).

**2. Sign in to Xcode**

Install Xcode from the Mac App Store and open it once to finish installing. In Xcode, open **Settings › Accounts** and sign in with your Apple Account. If you need a signing certificate, select your team, open **Manage Certificates** and add an **Apple Development** certificate.

**3. Save your team**

The Scrolly Mac app saves a single team automatically. If it finds several, pick yours and choose **Save**. If it finds none, use **Type it instead**. Find the 10-character ID in [Membership details](https://developer.apple.com/help/glossary/team-id/) in your Apple Developer account.

## Install on the phone

1. During [phone setup](https://docs.tryscrolly.com/quickstart.md#connect-your-mac-phones-and-accounts), choose **WDA** when **WDA or Native** offers both. On iOS 15 to 26, follow the WDA steps. Finish any Xcode and signing steps shown on the page.
2. Keep the phone plugged in, unlocked and trusting the Mac. Scrolly registers the phone with your developer team and installs the driver app. Each phone uses a device slot on your team.
3. If asked to trust the developer, open **Settings › General › VPN & Device Management** on the iPhone. Select your developer account and choose **Trust**. Follow any passcode prompt on the iPhone.
4. Wait for the install checklist to show the driver app is running. Scrolly checks that for you, then moves on to **Phone settings**.

If a build fails, follow the message on the install step. Once you've fixed the issue, the Mac retries by itself. You can also [recheck the install](https://docs.tryscrolly.com/reference/scrollyctl.md#setup-step) from Terminal. For Photos prompts, see [Photos access](https://docs.tryscrolly.com/guides/mac-permissions.md#photos-access).

## Switch a phone to WDA later

An Admin opens the phone's **Phone settings**, chooses **WDA** under **Driver mode** and confirms the switch. If the Mac still needs its developer team, use **Step-by-step guide** under **Set up WDA on this Mac**.

Choose **Open the install step** to see the same checklist used during setup. Keep the phone plugged in and unlocked and follow the instructions there. On iOS 27 or later, you can still watch the phone while the driver installs. Automation waits until WDA is running.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.