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.

How HelmSwarm connects iPhones to your browserYour own iPhones connect by USB to a Mac running the HelmSwarm agent, which opens an outbound encrypted WebSocket to the HelmSwarm panel; screens and commands are relayed through HelmSwarm's servers. Rented iPhones are hosted and connected by HelmSwarm. You use both from a web browser over HTTPS.Your iPhonesWebDriverAgent oneach deviceMac + HelmSwarm agenton your premisesno inbound portsHelmSwarm panelapp.helmswarm.combehind CloudflareRented iPhoneshosted by HelmSwarm · 1 Gbit/s · optional eSIMYour browserlive screens,control, runsUSBoutbound WSSHTTPS
Own devices connect through a Mac agent that dials out to the panel; rented devices are connected by HelmSwarm. Either way, screens and commands are relayed through HelmSwarm's servers and you work in the browser.

Connecting your own iPhones

For the Your Own Device package. You need a Mac that stays on and your iPhones on USB.

  1. 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.

  2. 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.

  3. 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.

  1. Request devices

    Tell us how many iPhones you need and any model or iOS requirements. We confirm availability and the quote.

  2. We set them up

    We prepare the devices, host them with power and 1 Gbit/s internet, and connect them to your workspace.

  3. 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.

More about renting iPhones

What happens when you tap

  1. You click on the live screen in your browser.
  2. The panel sends the tap to the device's agent over the encrypted connection.
  3. The agent passes it to WebDriverAgent on the iPhone, which performs a real touch through XCTest.
  4. 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.

Automation scenarios and schedules →

Requirements at a glance

What you need on your side
PackageYou provideHelmSwarm provides
Your Own DeviceiPhones, a Mac that stays on, USB connections, internetPanel, agent, onboarding, Ultra Support 24/7
Rental iPhoneA web browserDedicated iPhone, hosting, 1 Gbit/s internet, panel, Ultra Support 24/7
Rental iPhone + eSIMA web browser; your own eSIM, or ask us to provide oneDedicated 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.