Skip to main content
Introducing Bug Capture: A new way to report & resolve bugs: 20x faster, 100% less painful. Get free access now
No Result Found

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 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:

  1. Download and install BrowserStackLocal app or binary
  2. Launch BrowserStackLocal app (Applicable only to BrowserStackLocal app)
  3. Verify whether BrowserStackLocal app is running (Applicable only to BrowserStackLocal app)
  4. Connect the BrowserStackLocal app with Live (Applicable only to BrowserStackLocal app)
  5. Launch a local Live session and test
  6. Access your website on 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.

Live in-session download

The BrowserStackLocal.msi package is downloaded to your default downloads folder. You can also find the installer on your browser’s downloads page.

Windows Downloads folder

Install BrowserStackLocal app

  1. Double-click the BrowserStackLocal.msi installer file.
    You might get a security warning. Click Run to proceed. Security warning
  2. On the Welcome screen, click Next. Local Welcome screen
  3. Select the destination folder where you want to install the BrowserStackLocal app. Then, click Next. Destination folder
  4. On the Ready to install BrowserStackLocal screen, click Install.
    Ready to install screen
    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.
    Local installed

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:

Copy icon Copy

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.

Live in-session download
The BrowserStackLocal.pkg package is downloaded to your default download folder. You can also find the installer on your browser’s downloads page.

Mac Downloads folder

Install BrowserStackLocal app

  1. Double-click the BrowserStackLocal.pkg file.
    The installer launches.
  2. On the Introduction screen, click Continue. Introduction screen
    The installer takes the default destination for installation and goes to the Installation Type screen.
  3. (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. Change installation destination
  4. On the Installation Type screen, click Install.
    Install local

    The installer requests for your password to allow the installation. Enter the password and click Install Software.
    Click install software

    The Summary window confirms that the BrowserStackLocal app is installed. Click Close. Summary

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:

Copy icon Copy

A success message confirms that BrowserStackLocal is running on your system.

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:

Copy icon Copy

A success message is shown on the terminal confirming that BrowserStackLocal is running.

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.

BrowserStack Local app is running

You can see the BrowserStack Local app icon in the top menu bar.

BrowserStack Local app is running

Connect the BrowserStackLocal app with Live

This step is only applicable to the BrowserStackLocal app, and not the binary.

If you do not have the Live dashboard or Live session open in your browser, open the dashboard to initiate the connection between the BrowserStackLocal app and Live.

If you already have the Live dashboard open or a Live session running in your browser, the BrowserStackLocal app automatically connects with Live.

On the BrowserStackLocal app, the status shows as Connected, which indicates that 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 Troubleshooting connectivity issues.

Launch a local Live session and test

If you do not have a test session running in your browser, open the Live dashboard and launch a Live session and proceed with testing.

On the Live vertical toolbar, the green indicator beside the Local Testing option indicates that Local Testing is enabled for your session.
Local connected

If you had a test session already running before you connected BrowserStackLocal with Live, then the session restarts with the Local settings and the Local Testing indicator becomes green.

Local session restarts

Access your website on Live

In the Live session, enter your website address in the remote device browser (for instance, localhost:3000). You can now continue to browse and test your website as you would on your local device.

On iOS, the localhost URL doesn’t work. The localhost URL automatically changes to http://bs-local.com. If the localhost URL doesn’t change automatically, replace localhost with bs-local.com manually. For example, instead of using localhost:3000, use bs-local.com:3000. Also, ensure that your local server is configured to serve requests from bs-local.com.

Next steps

If you correctly set up Local Testing, and still unable to access your website on Live, 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





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