For Test Lab models such as Hybrid, we need to configure a local machine to execute the tests. We can do that by running a small utility program named 'Testsigma Agent' on the local machine. The Agent will do the required configuration, avoid the hassle of numerous configuration for end-users and allow us to concentrate on managing the tests alone.

Setting up your Local machine

Setting up your Windows, Mac or Linux Machine for Hybrid Execution consists of three steps. They are:

I. Download Testsigma Agent

II. Extract the Testsigma Agent-Drivers bundle

III. Start the Testsigma Agent Server

IV. Register the Testsigma Agent

I. Download Testsigma Agent

Download the Testsigma Agent by clicking on the Download Agent button in the Agent page as shown below:

Testsigma Dashboard PageAgents page

If you face any download issues, please download it from here manually.

Testsigma Agent Windows | Testsigma Agent Mac | Testsigma Agent Linux

II. Extract the Testsigma Agent-Drivers bundle

Extract the archive somewhere in your home directory to avoid file access permission issues. Here are the suggested locations to place the extracted Testsigma Agent folder:

Operating SystemPreferred Agent location

Replace the <your_username> part with your Account username.

The home directory is recommended so as to avoid hassles of setting file permissions and ownership and also to avoid file corruption due to constant syncing with iCloud or Google Drive.

III. Start the Testsigma Agent Server

For Windows

1. Navigate to the Testsigma Agent installation folder and double click on start.bat file.

Wait for the "Started TestsigmaAgent in X ms" message to come up. Your Testsigma Agent server is up and running now.

For Mac/Linux

1. Open Terminal and navigate to Testsigma Agent directory where you extracted the agent.

[/] - [$] cd /Users/renju/TestsigmaAgent

2. Start the Testsigma Agent by executing the file:

[/Users/renju/TestsigmaAgent] - [$] ./

Agent will start running as a background process. Wait for a few seconds. Your Testsigma Agent server is up and running now.

IV. Register the Testsigma Agent

A. Checking Agent running status

Once the Agent has started you will get a System Tray icon. The status will show as STARTED once it's ready. If it is showing the status as STARTING, please wait for a few moments for it to start. 

The same icon can be used to Quit and Restart the Agent.

Windows Agent System tray icon


Unix Agent System tray icon



B. Connecting the Agent to Testsigma App

1. Once your Testsigma agent is up and running, click on the Agent tab on Left-hand side Navigation bar.

2. Once you land on the Agent page you will see two options. Click on Add a new Agent

It will try to establish connection to the agent running on your machine as shown below:


3. If Agent is not running you will get the following error:


4. Enter a title/name for your machine and click on Save button.

By default, Agent will be Visible to Everyone. You can make this agent private to your account by unchecking Visible to Everyone.

Also, the values given for HTTP and HTTPS port can be left as it is. Only if you want to run the agent on different ports, change the values.

5. Once you have entered the Title, click on save to save the Agent. After saving, the agent that you registered will be displayed with all the available browsers in that Agent machine: 

Starting the Execution

We assume that you are already on the Test Case details page trying to create a Hybrid Dry Run or on the Test Plans page trying to create a Hybrid Test Plan.

If not, create a new Test Plan/Dry Run, select Hybrid as Test Lab Type and select your newly added Agent. 

Please refer this article for a detailed guide on creating a Hybrid Execution - How to Create a Hybrid Execution for running Tests on Local Machine?

Welcome to the era of #SmartTestAutomation!