Starting SecureTunnel

Applies to CrossBrowserTesting SaaS, last modified on February 16, 2021

After you have completed installing the SmartBear SecureTunnel app, you can launch the application in one of two ways:

  • Launch from the CrossBrowserTesting website Local Connection dialog (convenience).

  • Launch the application directly by finding SmartBear SecureTunnel app in your system applications.

Both the application and the website display a similar UI for starting a tunnel. The website dialog is used in the images below.

Start a new tunnel

As you can see from the image, you will choose a connection type and configuration options, described below.

Tunnel configuration

Click the image to enlarge it.

Internal websites

This is the most basic type of tunnel for a local connection. It creates an encrypted tunnel that allows traffic and requests to be routed through the local network of your computer. This allows you to test sites that are only accessible through your local network or behind your firewall.

  1. Select Internal Websites option.

  2. Click Connect.

Run tests
  • Run a Live Test to an internally resolved domain name

  • Run a Live Test using your internal IP Address:

  • Run a Live Test using the "local" keyword ("localhost" and "" are not supported on all devices): https://local:3000

  • Run a Screenshot Test using your internal IP address or use the keyword "local": https://local:3000/home

Local HTML files

This type of tunnel allows you to test static HTML files saved on your computer without being required to setup a web server.

  1. Select Local HTML Files option.

  2. Enter the full path to the top-level directory on your machine where the HTML files live. For example:
    Windows: c:\Users\John\Static-Html-Files
    Mac: /Users/John/Static-Html-Files

  3. Click Connect.

Run tests
  • Run a Live Test to https://local/ to get a full directory listing of your HTML folder and click on each file you want to test.

  • Run a screenshot to a single file, e.g., https://local/index.html

Proxy server

The final connection type allows you to specify a proxy server to route your traffic through during tests. This is especially useful for testing location-based content.

  1. Select Proxy Server option.

  2. Enter the IP address and Port number for the proxy server.

  3. Click Connect.

Run tests
  • Run a Live Test or Screenshot test to the website URL or IP address that needs to route through the proxy.


There are two additional options that can be specified when starting a tunnel through the UI (Find more options with the command-line and node packages).

Bypass tunnel for public URLs: Clicking this check box enables the tunnel to resolve publicly accessible sites without having to route through your machine– it will only attempt to resolve a domain name through your computer if it cannot resolve it publicly. This will generally speed up tests when enabled since many sites call publicly available resources.

Accept All SSL Certificates: Checking this option makes it so that all certificates are considered valid through the tunnel. This is useful for development versions of sites, which may use self-signed or invalid certificates.

Connection status

Once the tunnel is connected, you will see the follow screen with details and connection status:

Tunnel connection details

Click the image to enlarge it.

See Also

Installing SecureTunnel
Running SecureTunnel on the Command Line

Highlight search results