Sauce Runner CLI Introduction

Espresso for VDC Now Available on saucectl

Espresso testing for virtual devices is now supported on saucectl, our CLI tool used with Testrunner Toolkit. For details, see:




This page describes the general usage for the Sauce Runner tool, which is required to run Espresso and XCUITest automated mobile app tests on Sauce Labs real devices and virtual devices.

CLI Structure#

The command line structure for all Sauce Runner requests is as follows: <main class> [options] [command] [command options].

Use Cases#

  • Run tests in parallel across multiple devices.
  • Run subsets of tests against specific devices.
  • Set the options as environment variables that can be referenced in your testing scripts.
  • Pass options as command line parameters, which will take precedence over options set as environment variables.
  • Real Device testing only: Create a YAML test runner configuration file as an alternative to using inline commands.
Last updated on by Kim