Skip to main content
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.
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 in your Apple Developer account.

Install on the phone

  1. During phone setup, 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 from Terminal. For Photos prompts, see 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.