Set up Local Testing
Learn how to set up Local Testing.
To set up Local Testing, you need to either install the BrowserStack Local app or run the binary depending on the operating system and browser that you are using to access BrowserStack App Live.
To understand why you need to install the BrowserStack Local app or run the binary, see Why do you need to install the BrowserStackLocal app?.
The Local Testing setup involves the following high-level steps:
- Download and install BrowserStackLocal app or binary
- Launch BrowserStackLocal app (Applicable only to BrowserStackLocal app)
- Verify whether BrowserStackLocal app is running (Applicable only to BrowserStackLocal app)
- Connect the BrowserStackLocal app with App Live (Applicable only to BrowserStackLocal app)
- Launch a local App Live session and test
- Access your app on App Live
Download and install BrowserStackLocal
For the steps to download and install BrowserStackLocal, see the relevant section:
The OS mentioned in the following sections is the OS you are using to access BrowserStack.
To set up Local Testing you can use either BrowserStackLocal app or binary. If you want to set up Local Testing through a graphical user interace, you can download and install the BrowserStackLocal app. If you want to set up Local Testing through a command-line interface, you can run the BrowserStackLocal binary.
BrowserStackLocal app
Download BrowserStackLocal app installer
You can download the BrowserStackLocal app installer (BrowserStackLocal.msi) from the following sources:
After you download the installer or during the installation, you might get some security warnings depending on your organization’s security restrictions. You can still continue with the installation as the download links are secure. The installer is digitally signed, identifying the publisher as BrowserStack Ltd.
Direct download link:
Download the BrowserStack Local app
Live session: You can also download BrowserStackLocal.msi from the Local Testing option on the Live vertical toolbar.
The BrowserStackLocal.msi package is downloaded to your default downloads folder. You can also find the installer on your browser’s downloads page.
Install BrowserStackLocal app
- Double-click the
BrowserStackLocal.msiinstaller file.
You might get a security warning. Click Run to proceed.
- On the Welcome screen, click Next.
- Select the destination folder where you want to install the BrowserStackLocal app. Then, click Next.
- On the Ready to install BrowserStackLocal screen, click Install.
The installer requests for authentication to allow the installation.
The summary screen confirms that the BrowserStackLocal app is installed. Click Finish to close the installer.
BrowserStackLocal Binary
Download the BrowserStack Local binary for Windows.
After you download the binary or when you run the binary, you might get some security warnings depending on your organization’s security restrictions. You can still continue with the installation as the download links are secure. The binaries are digitally signed, identifying the publisher as BrowserStack Ltd.
Unzip the file to a folder/directory on your system, open the command-line interface, and navigate to the folder containing the Local binary.
Run the Local binary using the following command:
For next steps, see Launch a local test session and Access and test on your Local session.
To set up Local Testing you can use either BrowserStackLocal app or binary. If you want to set up Local Testing through a graphical user interace, you can download and install the BrowserStackLocal app. If you want to set up Local Testing through a command-line interface, you can run the BrowserStackLocal binary.
BrowserStackLocal app
Download BrowserStackLocal app installer
You can download the BrowserStackLocal app installer (BrowserStackLocal.pkg) from the following sources:
After you download the installer or during the installation, you might get some security warnings depending on your organization’s security restrictions. You can still continue with the installation as the download links are secure. The installer is digitally signed, identifying the publisher as BrowserStack Ltd.
Direct download link:
Download the BrowserStack Local app
Live session: You can also download BrowserStackLocal.pkg from the Local Testing option on the Live vertical toolbar.
The BrowserStackLocal.pkg package is downloaded to your default download folder. You can also find the installer on your browser’s downloads page.
Install BrowserStackLocal app
- Double-click the
BrowserStackLocal.pkgfile.
The installer launches. - On the Introduction screen, click Continue.
The installer takes the default destination for installation and goes to the Installation Type screen. - (Optional) If you want to change the destination folder, on the Installation Type screen, click Change Install Location. On the Destination Select screen, choose your desired location where you want to install the app and click Continue.
-
On the Installation Type screen, click Install.
The installer requests for your password to allow the installation. Enter the password and click Install Software.
The Summary window confirms that the BrowserStackLocal app is installed. Click Close.
BrowserStackLocal Binary
Download the BrowserStack Local binary for macOS/OS X.
After you download the binary or when you run the binary, you might get some security warnings depending on your organization’s security restrictions. You can still continue with the installation as the download links are secure. The binaries are digitally signed, identifying the publisher as BrowserStack Ltd.
Unzip the file to a folder/directory on your system, open the command-line interface, and navigate to the folder containing the Local binary.
Run the Local binary using the following command:
A success message confirms that BrowserStackLocal is running on your system.
For next steps, see Launch a local test session and Access and test on your Local session.
Download the appropriate BrowserStack Local binary for your system:
After you download the binary or when you run the binary, you might get some security warnings depending on your organization’s security restrictions. You can still continue with the installation as the download links are secure. The binaries are digitally signed, identifying the publisher as BrowserStack Ltd.
Unzip the file to a folder/directory on your machine, open the command-line interface, and navigate to the folder containing the Local binary.
Run the Local binary using the following command:
A success message is shown on the terminal confirming that BrowserStackLocal is running.
For next steps, see Launch a local test session and Access and test on your Local session.
Launch BrowserStackLocal app
This step is only applicable to the BrowserStackLocal app, and not the binary.
After the BrowserStackLocal app is installed, it starts automatically and you are not required to do anything to start the BrowserStackLocal app.
If the app doesn’t start automatically, follow these steps to launch the BrowserStack Local app:
Select the search button on the taskbar and type BrowserStackLocal. Click the BrowserStackLocal app from the search results to launch it. If the app doesn’t come up in the search results, you can find the app in the installation location you selected during the installation.
Open Finder. Then, go to the Applications folder and click the BrowserStackLocal app.
To know more about the options on the BrowserStackLocal app, see BrowserStackLocal app UI options.
Verify whether BrowserStackLocal app is running
This step is only applicable to the BrowserStackLocal app, and not the binary.
To verify whether the BrowserStackLocal app is running:
You can see the BrowserStack Local app icon in the Windows system tray.
You can see the BrowserStack Local app icon in the top menu bar.
Connect the BrowserStackLocal app with App Live
This step is only applicable to the BrowserStackLocal app, and not the binary.
If you do not have the App Live dashboard or App Live session open in your browser, open the dashboard to initiate the connection between the BrowserStackLocal app and App Live.
If you already have the App Live dashboard open or a App Live session running in your browser, the BrowserStackLocal app automatically connects with App Live.
On the BrowserStackLocal app, the status shows as Connected, which indicates that App Live is now connected to BrowserStackLocal.
On the BrowserStackLocal app, if the status shows as Disconnected, then your setup might have network restrictions such as WebSockets traffic being blocked by the network or proxy server being used to access the internet. To resolve these issues, see Troubleshoot connectivity issues.
Launch a local App Live session and test
If you do not have a test session running in your browser, open the App Live dashboard and launch an App Live session and proceed with testing.
On the App Live horizontal toolbar, the green indicator beside the Local Testing option indicates that Local Testing is enabled for your session.
If you had a test session already running before you connected BrowserStackLocal with App Live, then the session restarts with the Local settings and the Local Testing indicator becomes green.
Access your app on App Live
In the App Live session, you can access and interact with your app as you would on a physical mobile device, regardless of whether the app interacts with one or multiple servers.
If your organization requires all the traffic to be routed through your network, you can enable the Force Local flag.
Due to security restrictions in Safari (on iOS 10 and later), localhost URLs will automatically change to bs-local.com. This lets us load your app assets properly. Remember to ensure that your local server is configured to serve requests from bs-local.com.
Next steps
If you correctly set up Local Testing, and your app is still unable to access the internal servers, you might have network restrictions. Based on your network restrictions, refer to the relevant topic:
For troubleshooting issues, see:
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!