Error - Browser launch failure

Learn how to fix errors related to browser launch failures in Percy

In Percy, the browser launch failure error usually happens because of the following reasons:

• Missing dependencies to launch the browser
• Resource crunch on the user/CI machine

Try these solutions to resolve this error:

Solution 1: Install missing dependencies

Try installing the following Chromium dependencies for Ubuntu and Debian OS types.

Dependencies List

For other missing packages, manually trigger the apt install <package_with_appropriate_version> command to install the package compatible with your OS.

For example, let’s assume you receive the following error:

libnss3.so: cannot open shared object file: No such file or directory

To fix this error, execute the following commands:

apt install libnss
apt install libnss3-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxss-dev

Usually, a simple search with the error message gives you the packages that you’d need to install.

Solution 2:

• If the browser launch failed to find the executable to launch the browser, try using the PERCY_BROWSER_EXECUTABLE env variable to set the correct browser executable path.
• Ensure the browser binary you use is compatible with your machine. For example, using a 32-bit ARM binary executable on a 64-bit machine can cause lower performance risk and may hamper the execution time to launch the browser.

Reference Topic

• Percy Common error messages