We use cookies to enhance user experience, analyze site usage, and assist in our marketing efforts. By continuing to browse or closing this banner, you acknowledge that you have read and agree to our Cookie Policy, Privacy Policy and Terms of Service.

Browserstack logo
  • Live for Teams
  • Pricing
  • Manual Testing

    Live

    Cross-browser testing

    Accessibility Testing

    Test WCAG compliance

    Test Automation

    Automate

    Browser automation grid

    Automate TurboScale

    Automation on your Cloud

    Accessibility Automation

    Automate WCAG testing

    Percy

    Visual testing & review

    Low Code Automation

    Automation without coding

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Observability

    Test debugging & insights

    Empower teams with BrowserStack for Enterprise →

    Tools: Speedlab , Screenshots , Responsive

    Manual Testing

    App Live

    Real device testing

    Test Automation

    App Automate

    Real device automation cloud

    App Percy

    Visual testing for mobile apps

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Observability

    Test debugging & insights

    Empower teams with BrowserStack for Enterprise →

    • Documentation
    • Support
    • Status
    • Release Notes
    • Open Source
    • Events
    • Champions
  • Live for Teams
  • Pricing
  • Sign in
  • Free Trial
  • Manual Testing
  • Live
    Manual cross-browser testing
  • Accessibility Testing
    Super app to find & report issues
  • Test Automation
  • Automate
    Browser automation grid
  • Percy
    Visual testing & review
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Observability
    Smart test reporting & debugging
  • For Teams
  • Enterprise
  • Manual Testing
  • App Live
    Manual real device testing
  • Test Automation
  • App Automate
    Real device automation cloud
  • App Percy
    Visual testing for mobile apps
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Observability
    Smart test reporting & debugging
  • For Teams
  • Enterprise
  • Documentation
  • Support
  • Status
  • Release Notes
  • Open Source
  • Events
  • Champions
  • Documentation
  • Developer tools
  • Integrations
  • Integration URL
  • Local testing
  • References
  • Features
  • Mobile Features
  • Test on Right Devices
  • Browsers & Devices
  • Security
  • Status
    Home Local Testing Local Testing Internals

    Local Testing Internals

    Description of the data flow process, security policies, and internal architecture for Local Testing on BrowserStack.

    Local Testing Internals pdf Download

    Connection setup

    Local Testing
    • STEP 1: BrowserStack Local makes a REST call using the user's access key to browserstack.com.

    • STEP 2: browserstack.com chooses a repeater to establish a secure connection for Local Testing. The repeater exists within the BrowserStack cloud infrastructure.

    • STEP 3: browserstack.com supplies BrowserStack Local with the information necessary to establish a connection with the repeater.

    • STEP 4: BrowserStack Local initiates a connection to the repeater on port 443, using our custom SSL-encrypted protocol.

      Note: The repeater cannot directly initiate a connection to BrowserStack Local.

    • STEP 5: A secure, bi-directional, and persistent connection is established between the end user machine and the repeater. We use Secure WebSockets as part of our communication framework. If your enterprise firewall blocks the WebSocket protocol, we fall back to a legacy protocol which is also SSL encrypted, but much slower than WebSockets. For best results, we recommend that outgoing WebSocket connections be allowed in your firewall.

      Note: The secure connection is only established up to the user's machine (i.e. BrowserStack Local). Neither the repeater, nor any other BrowserStack machine, can directly access your local or internal servers. Only the servers specified for establishing a Local Testing connection can be accessed through the app.

    Data flow

    Data flow
    • STEP 1: The user sends a request to browserstack.com to start the remote browsing session.

    • STEP 2: browserstack.com identifies a virtual machine from the cloud, and allocates it to the user. The remote browser is started on this virtual machine, and the user will interact with it during their testing session. browserstack.com also instructs the virtual machine to use the repeater as a proxy.

    • STEP 3: browserstack.com instructs the repeater to allow access for virtual machine in its access control layer (ACL).

    • STEP 4: All the requests on virtual machine use the repeater as a proxy to resolve web traffic.

    • STEP 5: Requests from the remote browser are then routed to BrowserStack Local, through the secure connections described in the previous step.

    • STEP 6: BrowserStack Local then forwards these requests to the local server. All responses are sent back via the same channel.

    Teardown process

    Stopping the remote browsing session

    Stopping remote browsing session
    • STEP 1: The user sends a request to browserstack.com to end the remote browsing session.

    • STEP 2: browserstack.com instructs the repeater to sever the secure connection to the virtual machine in the cloud.

    • STEP 3: The repeater then severs the connection to and from the virtual machine.

    • STEP 4: browserstack.com takes the virtual machine offline, to securely erase all user information such as browser history, cookies, cache, form data, downloaded files (if any), saved passwords, etc. and restore it to its original, pristine state. This ensures that the virtual machine does not retain any information pertaining to the user's session.

    • STEP 5: Repeater confirms to BrowserStack Local that the virtual machine has been disconnected.

    • STEP 6: BrowserStack Local closes any open connections it had established to the local servers, ending the Local Testing session.

    The secure connection between BrowserStack Local and the repeater remains alive, and can be used for another remote testing session on another platform or with another browser.

    Stopping the Local Testing connection (Only for command line binaries)

    Stopping the Local Testing connection
    • STEP 1: The user requests a teardown of the Local Testing connection by hitting Ctrl + C from their command-line interface. Immediately BrowserStack Local severs the secure connection with the repeater. It also deletes all the information it had about the repeater. Thus it cannot set up another connection unless the user initiates it.

    • STEP 2: BrowserStack Local informs browserstack.com about the disconnect request.

    • STEP 3: browserstack.com makes sure the repeater also closes the connection from its end and deletes any information about the concluded Local Testing session.

    Recommended setup

    Recommended Setup

    BrowserStack Local is capable of establishing the Local Testing connection through most enterprise proxy servers and firewalls. The app makes two types of outgoing connections which may require special rules in your enterprise proxy and firewall:

    Type 1

    HTTP(S) requests to www.browserstack.com in the form of web requests (when the website is opened in the user's browser) and AJAX calls (for setting up Local Testing) at port 80 and 443.

    Type 2

    Secure WebSocket (WSS) connections to the repeater (*.browserstack.com) at port 443.

    The proxy server should support WebSockets and the CONNECT method to allow TLS/SSL connections.

    Internal architecture of BrowserStack Local

    Internal architecture of BrowserStack Local

    BrowserStack Local has three main modules:

    The Connection Manager

    Responsible for authenticating the user using their access key and establishing a secure connection to the repeater. It makes sure the connection does not drop while the user is testing and closes the connection when the user disconnects.

    TCP Level Proxy

    The Local Testing connection is designed to provide a transparent communication channel between the remote web browsers (on BrowserStack infrastructure) and the user's local servers. Unlike traditional HTTP proxies, BrowserStack does not look into the request headers or any user data. BrowserStack Local enables a TCP level connection to be established between the remote browser and the local servers. This allows for testing of HTTPS websites and technologies such as WebSockets.

    HTTP Server

    This applies to local folder testing only. When the user wishes to test local HTML design files, BrowserStack Local starts a tiny HTTP server within the app on a random unprivileged (>40000) port. This HTTP server has read-only access to the folder mentioned by the user. It loads a file from disk only when requested and does not cache file data. It is shut down when the Local Testing connection is disconnected.

    This HTTP server is treated as a local server and the aforementioned mechanism takes over.

    In This Article

    • Connection setup
    • Data Flow
    • Teardown process
      • Stopping remote browsing session
      • Stopping the Local Testing connection
    • Recommended setup
    • Internal architecture of BrowserStack Local

    Related Articles

    Local Testing

    Inbound IP Whitelisting

    Local Binary Release Notes

    Products

    • Live
    • Automate
    • Automate TurboScale Beta
    • Percy
    • App Live
    • App Automate
    • App Percy New
    • Test Management New
    • Test Observability New
    • Accessibility Testing New
    • Accessibility Automation Beta
    • Low Code Automation Beta
    • Nightwatch
    • Enterprise

    Tools

    • SpeedLab
    • Screenshots
    • Responsive

    Platform

    • Browsers & Devices
    • Data Centers
    • Device Features
    • Security

    Solutions

    • Test on iPhone
    • Test on iPad
    • Test on Galaxy
    • Test In IE
    • Android Testing
    • iOS Testing
    • Cross Browser Testing
    • Emulators & Simulators
    • Selenium
    • Cypress
    • Android Emulators
    • Visual Testing

    Resources

    • Test on Right Devices
    • Support
    • Status
    • Release Notes
    • Case Studies
    • Blog
    • Events
    • Test UniversityBeta
    • Champions
    • Mobile Emulators
    • Guide
    • Responsive Design

    Company

    • About Us
    • Customers
    • Careers We're hiring!
    • Open Source
    • Partners
    • Press
    BrowserStack Logo An illustrated of BrowserStack Logo

    Social

    • BrowserStack Twitter Account An illustrated of white twitter Logo
    • BrowserStack FaceBook Account An illustrated of white FaceBook Logo
    • BrowserStack LinkedIn Account An illustrated of white LinkedIn Logo
    • BrowserStack Youtube Channel An illustrated of white youtube Logo
    • BrowserStack Instagram Account An illustrated of white instagram Logo
    BrowserStack Contact Us Icon An illustration of white contact us icon Contact Us

    © 2023 BrowserStack. All rights reserved.

    • Terms of Service
    • Privacy Policy
    • Cookie Policy
    • Sitemap