Skip to main content

Replay Quickstart

Use saucectl — the Sauce Labs test orchestrator CLI — to replay Chrome DevTools Recordings.

  • Don't have a DevTools recording but want to try? Follow the steps below to use the Replay Demo Repo to build a sample project structure, working configuration file, and sample recording get up and running in less than 10 minutes!

What You'll Need

Step 1: Install saucectl

In a terminal shell, run the install command from your chosen saucectl home directory.

npm install -g saucectl

saucectl requires access to a valid Sauce Labs account.

Use Environment Variables

saucectl detects your Sauce Labs credentials environment variables and prioritizes them over values in the credentials.yml file when both are present. If you have set them, you may skip this step. Not sure if you have them set? Run the following command to check:


If a value is returned for both variables, they are set.

  1. Run the configure command:

    saucectl configure
  2. Enter your Sauce Labs username and access key at the prompts.

Step 3: Set up Your Replay Project

Clone the Replay Demo Repo to get a project structure, configuration file, and sample recording. Use the command below that is applicable to your GitHub setup.

git clone

Step 4: Replay Recordings

Navigate to the root of the Replay project you just cloned, then use the run command to replay the sample recording included with the saucectl example.

cd saucectl-replay-example
saucectl run

The results are available immediately following job completion in your Sauce Labs Dashboard.

Step 5: Roll Your Own

Ready to create your own recordings? Follow this tutorial and export your DevTools Recording to JSON.