Documentation
Troubleshooting
Start with a health check. It unlocks the phone, screenshots it and proves a swipe lands, which rules out most of what follows.
Error messages
Xcode is not selected
The Mac is pointed at the command line tools, which cannot build for a device. This is the most common install failure.
sudo xcode-select -s /Applications/Xcode.app/Contents/DeveloperXcode is not installed
Install Xcode from the App Store and open it once so it finishes setting itself up, then run the install command again.
Node 20 is too old
The agent needs Node 22 or newer. Install it, then run the install command again.
That token does not look right
The install command was pasted without its token, or only part of it. Copy the whole line again from Machines.
The screen did not change after a swipe, so touch is not reaching the device
The harness is installed but input is not landing. Usually the phone is locked, or it is showing a system dialog that swallows the gesture. Unlock it, dismiss anything on screen, and run a health check again.
This task needs a device, but WebDriverAgent is not configured on this agent
The automation harness has not been built for this phone yet. Check that the device is enrolled and that the first build finished.
XCUITest driver not found
The dependency install did not complete. Reinstall the agent.
appium driver install xcuitestNo media was attached to this post
A posting task ran with nothing to post. Upload the files under Media and attach them when creating the schedule.
The phone stopped responding after a week
A free Apple ID signs the harness for seven days. When it expires the phone goes quiet until the harness is rebuilt, which happens by re-enrolling the device. A paid Apple Developer account extends this to a year.
Nothing runs at the scheduled time
Work only happens while the agent is awake. Check, in order:
- The Mac was awake. Sleeping through the window skips the run rather than queuing it.
- The machine shows as online under Machines.
- The schedule is active rather than paused.
If the agent is not reporting, look at its log:
tail -f ~/.appfarmmagic/logs/agent.logA phone disappears under load
Several iPhones on an unpowered hub will brown out and drop off the bus. Use a powered hub, and prefer the cables that came with the phones.
Still stuck
Email support@appfarmmagic.com with the device and the run that failed. The per-run log in the dashboard has the detail we need. There is also a first phone walkthrough covering setup end to end.