How can we help?

When using BrowserStack Local, I encountered the ‘self signed certificate in certificate chain‘ error. What should I do?

This error occurs if you have SSL inspection enabled on your network. Take one of the following actions to resolve this issue:

- Work with your network administrator to allow traffic to the *.browserstack.com domain to bypass SSL inspection.

- Disable SSL inspection entirely for BrowserStack Local connections.

- If you are on Windows, pass the root CA certificate to the BrowserStack Local. You can set the certificate in one of the following ways:

- In browserstack.yml, use the following syntax:

browserstackLocal: true

browserStackLocalOptions:

  --use-ca-certificate: <PEM_file_abs_path>

- In the CLI, when starting the local binary, use the following command:

./BrowserStackLocal --key <access_key> --force-local --use-ca-certificate <PEM_file_abs_path>

- If you are on macOS or Linux, pass the system-installed certificate to the BrowserStack Local. You can set the certificate in one of the following ways:

- In browserstack.yml, use the following syntax:

browserstackLocal: true

browserStackLocalOptions:

  --use-system-installed-ca

- In the CLI, when starting the local binary, use the following command:

./BrowserStackLocal --key <access_key> --force-local --use-system-installed-ca

For more information, see Setting up Local with SSL Inspection in Network in BrowserStack documentation. To see the list of flags you can use with BrowserStack Local, see Flags for Local Binary.

Other Resources

Still can’t find what you are looking for?

We are always happy to help with any questions

Support resources Contact Us

Provide your business email to continue