Troubleshooting Guide

Cypress won’t start

`Can’t run because you’ve entered an invalid browser name`

bash
Can't run because you've entered an invalid browser name.

Browser: Replay Chromium was not found on your system or is not supported by Cypress.

Cypress supports the following browsers:
 - electron
 - chrome
 - chromium
 - chrome:canary
 - edge
 - firefox

You can also use a custom browser: https://on.cypress.io/customize-browsers

Available browsers found on your system are:
 - chrome
 - chromium
 - firefox
 - firefox:dev
 - firefox:nightly
 - electron
 - Replay Firefox

This is expected (for now). Check first whether the process exits immediately, chances are the test ends up proceeding as expected!

While modifying cypress.config.js, make sure you’re returning the config object in setupNodeEvents

Make sure you’re using the correct browser for your operating system. replay-chromium is only supported on linux, whereas replay-firefox supports both mac and linux.

The environment variable CYPRESS_INSTALL_BINARY may be suppressing the browser install step. If it’s set to 0, make sure to add an explicit workflow step to install the browsers (npx @replayio/cypress install)

Your caching strategy might be keeping our plugin from pulling in the correct browser. Start debugging it by turning off all caching, e.g. actions/cache

DeploySentinel

If you’re using DeploySentinel, you may notice that either you are unable to record replays or the replays created do not show the Cypress Panel when you open them. This is caused by environment variables set by our plugin that are not passed on by DeploySentinel.

Fortunately, you can set this manually on the command line or in your CI configuration. Follow the instructions for running with earlier versions of Cypress to configure RECORD_REPLAY_METADATA_FILE (and RECORD_ALL_CONTENT if you’re using Firefox).

bash
RECORD_REPLAY_METADATA_FILE=/tmp/replay-metadata.json npx run cypress