Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & Accessibility Testing
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

Troubleshoot Local Testing in App Live

Find and fix issues that stop Local Testing from working in App Live, from installing BrowserStack Local to reaching your internal servers.

Local Testing issues in BrowserStack App Live usually happen at one of two stages:

  • Setup: BrowserStack Local isn’t downloaded, installed, or connected to your App Live session.
  • Traffic: BrowserStack Local is connected, but your app still can’t reach your internal servers through the Local tunnel.

Find your issue

Issues occur in a predictable order. Go through the following checkpoints from the top, and stop at the first one that describes your issue. Each checkpoint links to its fix:

# Issue Fix
1 BrowserStack Local isn’t downloaded on your machine. Download BrowserStack Local
2 BrowserStack Local is downloaded but isn’t installed or running. Install and run BrowserStack Local
3 Your browser doesn’t let App Live connect to BrowserStack Local. Allow browser permissions for App Live
4 BrowserStack Local still shows Disconnected after you click Connect. Connect through a corporate proxy or restricted network
5 Local Testing turns off after you set an IP location in your session. Turn off the IP location
6 Requests that must stay inside your network go through BrowserStack Local. Turn Force Local on or off
7 Your internal environment or login page doesn’t load while Local Testing is on. Resolve unreachable internal servers
8 Your app calls localhost, which points to the BrowserStack device instead of your machine. Replace localhost in your app
9 On iOS, your local server rejects requests sent to bs-local.com. Allow requests to bs-local.com on iOS

Checkpoints 1 to 5 cover setup. If BrowserStack Local is connected and the green indicator appears beside Local Testing on the App Live toolbar, start from checkpoint 6.

Troubleshoot by stage

Collect details before you contact Support

If the guides don’t resolve your issue, contact BrowserStack Support with the following details to speed up the investigation:

  • Whether you use the BrowserStack Local app or the Local binary, and its version.
  • The OS of the machine that runs BrowserStack Local, and the browser you use for App Live.
  • The status that BrowserStack Local shows, such as Connected or Disconnected, and any error message.
  • Whether Force Local or Force Proxy is on.
  • The host and port your app calls, and the error your app shows.
  • For the Local binary, the output of the binary run with the --verbose 3 flag.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle