We would like you to know that Local Applications are not accessible via Testsigma Labs or any other Cloud Execution Models since the application is on a local network and Testsigma Labs uses Cloud devices. That is why we need to use Hybrid Executions in these cases - Why Cloud Test Environments can't access Locally hosted Applications?

Given below is a step by step guide for executing your Web Application tests in Hybrid Model using Testsigma.


  • Create a Project, add an Application and an Application Version inside it.
  • Create a Test Case and add a few Test Steps in it.
  • Create a Test Suite and add the Test Case to it.

Creating a Project, Application and Application Version

If you are new to Testsigma and you are not yet familiar with Testsigma Project Hierarchy, check the Sample Project article to get familiar with the Project organization in Testsigma.

A Sample Project explaining the Testsigma Hierarchy

After that, please check the below article for a detailed guide to creating Projects, Applications, and Versions.

How to Create/Edit/Delete Project?

Create a Test Case and add a few Test Steps in it

Please check the following articles for a detailed guide to creating Test Cases and Test Steps:

How to add/edit/delete an automated Test Case?

How to add/edit/delete automated Test Step?

Create a Test Suite and add the Test Case to it

Please check this article for more details on creating a Test Suite - How to add/edit/delete Test Suite?

You can bypass the Test Suite creation requirement by using a Quick Run or Dry Run.

Please check this article for more details on Quick Run and Dry Run - Different Types of Execution Methods in Testsigma


Considering you already have a Test Suite containing Web Application Test Steps, the procedure for Executing a Web Application in Testsigma in a local environment are as follows:

1. Add the local test machine(PC) as a System in Testsigma.

2. Set up the local PC for hybrid Execution by installing Testsigma Agent.

3. Create Execution and add Execution Configuration.

4. And finally, start the Execution!

Add the local test machine as a System in Testsigma

Assuming that you have a Web Application Version and a Test Suite consisting of a Test Case inside it ready for Execution, we can move onto setting up the local machine for Hybrid Execution. But before that, we need to add the local machine to Testsigma Database to be selected as the Test Machine while creating Execution.

Please check this article for creating a System: How to add/edit/delete System?

Once the local machine is added to Testsigma, we can move onto setting the machine up for Hybrid Execution by installing Testsigma Agent and configuring it.

Set up the local machine for hybrid Execution

Once the local System is added to Testsigma, we need to perform some configurations on the Local machine where tests are to be run.

This is done so that the local machine can accept communication in the form of HTTP packets from Testsigma servers. This step is preconfigured in other Cloud Execution Models such as Testsigma Labs, Sauce Labs, and BrowserStack. If you prefer the easy method, you may use the cloud execution models in which you can select the execution environment from the list of available OS/Browser/Version Combos. Please check this article for more details - How to execute tests in Testsigma Labs, Sauce Labs or Browserstack?

Continuing with the Hybrid Execution setup, we need to first set up the Testsigma agent on the local PC. Please check the following article for a detailed guide on setting up Testsigma Agent on local PC for Hybrid Execution:

Quick setup guide - Setup TestSigma Agent on your device for Hybrid Test Execution

Now we can create the Execution Configuration in which we will specify the necessary device details we set up till now.

Create Execution and add an Execution Configuration

We are almost there. The local machine is configured with Testsigma Agent and the machine is ready to accept communications from Testsigma servers to start the Execution. Also, Appium Server which routes the Commands from the PC to the mobile device is running(we started it in the previous step) in the background.

Now we can start creating the Execution. Please check the following article for a detailed guide:

How to create/edit/delete Executions?

How to add/edit/delete Execution Configuration?

Once the Execution Configuration is created, we can finalize the Execution creation by clicking on Create button.

Start the Execution

Make sure the following conditions are met before starting the Execution:

  • Make sure the Testsigma Agent that we started earlier is running by refreshing the Agent Dashboard page.
  • Also, check the Agent is running in a command prompt window titled 'Tomcat'

Once all the above checks are done, you can start the Execution. Goto the Executions page on Testsigma App and click on Run Now near the corresponding Execution name. You will be able to see your Execution name and the 'Running' status on the Executions page.

You have successfully configured your machine to run Tests locally. The Agent server will wait for the request from Testsigma Website App and the tests would start running in a few moments on our local machine.

Welcome to era of #SmartTestAutomation!