19 Jun

Starting Appium Via launchd

In a recent project I needed to find a way of getting the Appium node.js app to run all the time on an iOS CI server. The requirements were as follows:

  1. Appium must be run from the checked out Git repository
  2. Launch Appium on start-up, in case the server needs to be rebooted
  3. If Appium crashes (it does sometimes), relaunch the server
  4. Output stdout and stderror to a log file that I can easily view using Console.app to debug problems with Appium

This was achieved with the following launchd plist configuration file placed in ~/Library/LaunchAgents/.


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">


The WorkingDirectory setting is required, as Appium uses it to locate the instruments/client.js file.

Start the agent by running:

launchctl load ~/Library/LaunchAgents/<configuration name>.plist

Or stop it by running:

launchctl unload ~/Library/LaunchAgents/<configuration name>.plist

Hope this helps!

One thought on “Starting Appium Via launchd

Leave a Reply

Your email address will not be published. Required fields are marked *