Appearance
iPhones
BenchFleet runs iPhones plugged into this computer by USB, next to your Android phones. Everything is set up on Settings → iPhones, in the order below. What an iPhone can and cannot do here is on Control your iPhones from Windows, Mac or Linux.
1. Apple's USB service
- Windows: install Apple Devices from the Microsoft Store (or iTunes). Nothing to sign in to.
- Linux: install and start
usbmuxd, and install libimobiledevice 1.4 or later, from your distribution's packages. - Mac: install libimobiledevice 1.4 or later (for example from Homebrew). Apple's USB service is built in.
2. The iPhone tools
Settings → iPhones → Download the iPhone tools (about 75 MB). BenchFleet downloads libimobiledevice (LGPL, run unmodified as separate programs), Appium's iOS libraries (Apache-2.0) and the Node.js that runs them, Appium's WebDriverAgent (BSD-3) and zsign (MIT, which signs it for you), from GitHub, nodejs.org, npm and MSYS2, and checks each against its pinned checksum. They are not part of BenchFleet, and you don't need Node.js yourself. On Linux and a Mac, libimobiledevice comes from step 1 instead. In Local mode nothing leaves the computer, so switch to API mode (Settings → Privacy) first, or run controlhub ios setup from the command line.
iOS 17 or later: Start the iPhone connection. These iPhones talk to BenchFleet through a small network link over the USB cable. Creating it needs administrator rights, so press Start the iPhone connection and answer Yes when Windows asks. Do it once each time the computer starts. On Linux and a Mac the page shows the sudo command to run instead. BenchFleet itself never runs as administrator.
3. Trust this computer
Plug the iPhone in with a cable, unlock it, tap Trust and enter the iPhone's passcode. The page then lists the phone. BenchFleet never answers this prompt for you.
4. Sign the helper app with your Apple account
Apple lets the helper app run only when an Apple account of yours signs it for your iPhones. BenchFleet cannot sign it for you and never asks for your Apple ID password. Choose one:
Your Apple Developer account (recommended, paid). An Admin or the Account Holder of your team does this once:
- Sign in at appstoreconnect.apple.com and open Users and Access → Integrations → App Store Connect API → Team Keys. Press +.
- Name it "BenchFleet", choose Admin access and generate it.
- Copy the Issuer ID (above the list) and the key's Key ID, and download the key file (
AuthKey_….p8). Apple lets you download it only once. - In BenchFleet, enter both IDs, choose the file, press Check and save the key, then Sign and install.
BenchFleet then makes a development certificate (from a key made on this computer that never leaves it), registers your iPhones, signs and installs the helper app, adds iPhones you plug in later and renews everything before it ends. Each iPhone uses one of your team's 100 iPhone registrations a year. The key is kept encrypted on this computer, is sent only to Apple, and needs API mode. BenchFleet never revokes your other certificates.
A certificate and profile you already have. Choose your development certificate (.p12) and an iOS App Development profile (.mobileprovision) that lists your iPhones, and enter the certificate's password (used once, never stored). A new iPhone or an ending profile needs a new profile from developer.apple.com.
A free Apple ID: Xcode on your Mac. Build WebDriverAgent with Xcode, signed with your personal team, install it on the iPhone, and enter its bundle ID on the page. Apple ends free signing after 7 days, so repeat it weekly.
Not now. The iPhone is listed with its details and battery, and you can install and remove .ipa apps. There is no live picture, tapping or automation.
5. Developer Mode
After the helper app is on the iPhone: Settings → Privacy & Security → Developer Mode on, restart, then tap Turn On and enter the passcode. Then open the iPhone in BenchFleet and switch automation on. Keep it unlocked while automation runs: a locked iPhone stops automation for you to unlock it.
When something does not work
| You see | What to do |
|---|---|
| "Apple's USB service is not running" | Windows: install Apple Devices or iTunes. Linux: start usbmuxd. |
| No iPhone listed | Unplug it, plug it in again, unlock it and tap Trust. Try another cable: some only charge. |
| "BenchFleet may not reach Apple" | Switch to API mode in Settings → Privacy, then save the key again. |
| "Apple did not accept the API key" | Check the Issuer ID, the Key ID and that the file is the .p8 of that key. |
| "The API key may not do this" | Make a Team Key with Admin access (an individual key cannot register devices). |
| "Every connected iPhone is in use" | Switch automation off on the phone's page, then sign again. BenchFleet never replaces the helper app while it runs. |
| Developer Mode is missing on the iPhone | It appears only after the helper app is installed: sign first. |
| Automation does not start on iOS 17 or later | Press Start the iPhone connection on Settings → iPhones (needed again after the computer restarts). |