How it works
How HelmSwarm works
Each iPhone runs WebDriverAgent, Apple's XCTest-based automation server, which streams its screen and accepts input. Your own iPhones connect by USB to a Mac running the HelmSwarm agent, which opens an outbound encrypted WebSocket to the HelmSwarm panel, and screens and commands are relayed through HelmSwarm's servers; rented iPhones are connected by us. You use all of them from a web browser.
The moving parts
Three pieces work together: the device, the connection, and the panel.
Connecting your own iPhones
For the Your Own Device package. You need a Mac that stays on and your iPhones on USB.
Prepare the Mac and devices
Connect your iPhones to the Mac by USB. On iOS 16 and later, switch on Developer Mode; older iOS versions need a Developer Disk Image, which the agent mounts for you.
Start the agent
Download the agent from the panel's Connect page and start it with your connect token. It finds the iPhones and starts WebDriverAgent on each one.
Work in the browser
Devices appear on your device wall within moments. If the Mac loses its connection, the agent reconnects by itself when it can.
The on-device automation app (WebDriverAgent) must be signed for each iPhone. We walk you through signing and device setup during onboarding.
Using rented iPhones
For the Rental iPhone and Rental iPhone + eSIM packages.
Request devices
Tell us how many iPhones you need and any model or iOS requirements. We confirm availability and the quote.
We set them up
We prepare the devices, host them with power and 1 Gbit/s internet, and connect them to your workspace.
Start testing
The iPhones are on your device wall with 24/7 instant access. Install your builds and go. On the eSIM package, add your own eSIM or use one we provide.
What happens when you tap
- You click on the live screen in your browser.
- The panel sends the tap to the device's agent over the encrypted connection.
- The agent passes it to WebDriverAgent on the iPhone, which performs a real touch through XCTest.
- The screen changes, and the new frames stream back to your browser.
Scenarios work the same way
A scenario run sends each step through the same path, on every selected device — in parallel or one after another — and records the result and screenshots per device. That's why anything you can do by hand, you can automate.
Requirements at a glance
| Package | You provide | HelmSwarm provides |
|---|---|---|
| Your Own Device | iPhones, a Mac that stays on, USB connections, internet | Panel, agent, onboarding, Ultra Support 24/7 |
| Rental iPhone | A web browser | Dedicated iPhone, hosting, 1 Gbit/s internet, panel, Ultra Support 24/7 |
| Rental iPhone + eSIM | A web browser; your own eSIM, or ask us to provide one | Dedicated iPhone, hosting, 1 Gbit/s internet, panel, Ultra Support 24/7 |
Setup questions
What do I need to connect my own iPhones?
A Mac that stays on, your iPhones connected to it by USB, and the HelmSwarm agent. The agent connects out to the panel over an encrypted WebSocket, starts WebDriverAgent on each iPhone and reconnects by itself if the connection drops. See how it works.
Is my own device available 24/7?
Your own devices are reachable whenever they and the Mac running the HelmSwarm agent are powered on and online. If the Mac sleeps or loses its connection, the device shows as offline until it's back.
Which iPhone models and iOS versions work?
HelmSwarm works with iPhones that can run WebDriverAgent. Devices on iOS 16 and later need Developer Mode switched on, and older iOS versions need a Developer Disk Image, which the HelmSwarm agent mounts automatically. Send us your models and iOS versions and we'll confirm compatibility before you order.
Are these real iPhones or simulators?
Real iPhones. Every device in HelmSwarm is a physical iPhone driven through Apple's XCTest framework via WebDriverAgent — not an iOS Simulator and not an emulator.
Where does my test data go?
With your own devices, the iPhones and the agent stay on your premises; the agent sends screen frames and command results to the HelmSwarm panel over an encrypted connection so you can use them in the browser. Scenarios, run results, screenshots and uploaded builds are stored by HelmSwarm. Read data residency for the full picture.
Can I install my own app builds?
Yes. You can install an .ipa on a device from the panel, uninstall apps, see installed apps and install a build on up to 20 devices at once. The build must be signed so it can run on that device.
Put real iPhones under one helm
Tell us how many devices you need and how you test. We'll confirm compatibility, pricing and the next steps by email.