Skip to content

Define a Link with a Squash Orchestrator test automation server

From Squash TM, you can start the execution of automated tests on Squash Orchestrator. This tool contains many micro-services that can be exploited by sending a workflow. This workflow enables you to orchestrate the execution of scripted automated tests in different automation technologies.

To interface Squash Orchestrator, you must have installed Squash AUTOM plugin on the Squash TM instance beforehand (Install Squash TM Plugins).


The Squash AUTOM plugin can be downloaded from the Downloads page. It exists in Community and Ultimate versions (available with Squash Ultimate license).

To execute automated tests from Squash TM with the Squash Orchestrator, you must define the link between Squash TM and the execution server by following the steps detailed hereunder.

Install and Configure Squash Orchestrator

To install and configure Squash Orchestrator, please read the Squash Orchestrator Installation Guide.

Add a Test Automation Server

You must add a Squash Orchestrator test automation server by following the procedure to Add a Test Automation Server. This will enable Squash TM to connect to the Squash Orchestrator.

Once you have added the server, you must link it to the Squash TM project on the Automation block of the project's configuration page.

Configure the test automation server for the project

Learn more

For test automation servers and projects, default values for environment tags and variables can be defined. For more information, visit the pages Define a default execution environment for Squash Orchestrator test automation servers and Associate a Test Automation Server to a Project

Add a Source Code Server

For Squash TM to be able to access the automated scripts that can be executed by the Squash Orchestrator, you must declare in the instance the source code repository that contains them.

You can access the management page of the source code management servers from the Administration workspace. This will enable you to Add a Source Code Management Server and to declare the repositories in question.

Once you have added the repository, you can select it in the field "Source Code Repository URL" of any test case or from the tables of the Automation workspace. Then, you can associate an automated script with it.

Define Squash TM's Public URL

You must imperatively enter Squash TM's public URL in the System Settings of the Administration workspace for the execution results of the automated tests executed in the Squash Orchestrator to be transmitted to Squash TM.

This URL prevails over the value of the property tm.test.automation.server.callbackurl that is in the file

Squash TM's public URL


To use Squash in DevOps, you must imperatively create a user belonging to the group "Test automation server" in Squash TM to be able to retrieve a Squash TM execution plan via a workflow sent from a pipeline. To learn more about the workings of Squash in DevOps, please read The Guide to Retrieve a Squash TM Execution Plan from a workflow.
You don't have to create a technical user to execute automated tests with Squash Orchestrator.