Join the webinar on 'Open source GenAI tools for Test Automation' on May 28th or May 30th.
A Complete Guide on How to Use HS Tunnel

A Guide on How to Use HS Tunnel

January 24, 2023
Christy ManjilaChristy Manjila
Christy Manjila
Abraham P KoshyAbraham P Koshy
Abraham P Koshy


Last year has been an amazing year for HeadSpin in terms of software updates. In HeadSpin’s latest software updates, the introduction of the HS tunnel has been a breakthrough one, as it helps securely connect HeadSpin devices to local or staging environments for the organization, teams, or individual users. This blog will help you understand HeadSpin’s latest feature, HS tunnel, and how to use it easily without any complications.

What is HS tunnel?

HS tunnel is a proprietary tool that is developed by HeadSpin to connect the cloud devices to your local machine to gain access to any local environments or even to get Charles proxy connected. It is a very diverse tool that can be seamlessly used by running very few commands in your terminal.


The first thing to do is to install the HS CLI tool that is available on the Platform. It is available for MAC, Linux, and Windows. The steps to download the tool are below.
Get the latest version of the HS tunnel installed by following the steps below:

1) Click on your name and Org name, which are on the top right of the UI.

Dashboard Home

2) Select "Settings." 


3) Go to the bottom, and you can see the link to download the CLI tool. Download the tool for your respective machine and install the tool.

Download cli tool

4) To check if you have the latest CLI installed, type "hs -V" in your terminal.

Once you have installed the CLI tool, you are all set to run the HS tunnel.

5) Make sure the api server is configured properly. If you receive an authorisation error , try running the command below:

hs config server

How to run:

To run the HS tunnel, all you have to do is follow the instructions below, and that's it, easy as that.

How to run HS tunnel:

1. Open the device and navigate to Tools tab on an Android device or the Overview tab on an iOS device.

navigating to the tools tab

2. Under "Local Environment Tunnel", set the rules and conditions which creates a command that is executable as a command line.

Local Environment Tunnel

3. Copy the command and run it on your terminal.

4. Verify that the hosts are connected by matching the hosts shown in the terminal as above with the one in the UI. Each device will have its hostname listed on the device's right side under the column "Hostname".

Verifying that the hosts are connected

The above command will get all the hosts in your account connected to your local machine. Once that is done. Start the device that you would want to connect to your local environment and click on the capture button.

Connecting the device to local environment

When you click on the capture button, you get two options: “With Network” and “Without Network.” Select “With Network,” and your device will be connected to your local environment.

connect device with network

Now when you check your public IP in the cloud device, it should show the IP of your home/office network.

A Guide on How to Use HS Tunnel

4 Parts


Perfect Digital Experiences with Data Science Capabilities

Utilize HeadSpin's advanced capabilities to proactively improve performance and launch apps with confidence
popup image