Skip to main content

Failed to launch the browser process

If you get an error message:

Failed to launch the browser process!
TROUBLESHOOTING: https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md // or a URL pointing to this page
Failed to launch the browser process!
TROUBLESHOOTING: https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md // or a URL pointing to this page

it means the browser was not able to start. The most common reasons are

Missing shared libraries

Install the missing shared libraries for your OS.

Wrong OS or architecture

If a x64 browser binary is run on arm64 or vice versa, you will get this error.
If the browser was compiled for a different OS or Linux distribution, it might also be incompatible. Make sure you are using the correct binary for your OS and architecture.

Debug using --log=verbose

Add the --log=verbose flag to the npx remotion render command.
This will log all browser process output, helping you to debug the issue.