Remote Testing with an attachable AUT

Last edited on


Suppose you want to do Remote Testing on a different machine, but you don’t want Squish to end your AUT process after the test case has been executed. Then you will need an attachable Aut.

Remote Setup

First you must do a little bit of Setup on the Remote Side, after the Installation of the Squish package. For this you edit the following file:


This file controls which IP addresses are allowed to contact the server. If the IP your local machine is not in there, the connection will be refused.

From within the IDE


You need to establish the remote connection to the squish server already running on the other machine.

This is done by going to

Edit > Preferences > Squish > Remote Testing

and unchecking the Checkbox there. After that you input the IP4 address of the machine where your remote squish server is running and the port if needed.

Once you are done with this, you must configure the attachable AUT in

Edit > Server Settings > Manage Auts > Attachable Auts

The name is just an identifier and should not be a path or anything more complex.


On the remote Side, you must start the Application through the start*aut.exe tool, which you can find in <SQUISHDIR>\bin.

The correct command for this looks in most cases something like this:

<startaut_name> --port=5555 <PATH_TO_APPLICATION_BINARY>

After that you can start the server from


For most cases, the most simple command works :

squishserver --verbose

If you need more information on the squish server you find that in the documentation : Squish Server

From the shell

If you are launching the tests from the shell in batch mode, you need to do some things differently, because you are not using the IDE.


On the remote Side, you must register the attachable AUT yourself before starting the server. This can be done through the follwing command:

squishserver --config addAttachableAUT <Identifier> [host:]port

The host argument is optional and if it is not entered, the attachableAUT will be registered for localhost.

After this is done you can start the server. For most cases, the most simple command works :

squishserver --verbose


The squish runner must be started with the –host argument to tell it which machine the server, it should connect to, is running on.