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
Download, install, and connect BrowserStack Local, including browser permissions and corporate proxies.
Fix requests that don't reach your internal servers even though BrowserStack Local is connected.
Resolve apps that call localhost, and local servers that reject bs-local.com on iOS devices.
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 3flag.
Related topics
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
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!