squishconfig

The squishconfig program is used to configure a specific Squish installation such that it uses a given license key and other system dependencies (such as a particular Java installation or a particular web browser).

Usage

<squishconfig> --licensekey=<STRING> [--python=<PATH>] [--java=<PATH>] [--swt=<PATH>] [--support-applets] [--qt=<PATH>]

Options

Option	Description
`--licensekey=<STRING>`	Defines the License Key to use for this Squish installation. You can get this from My Licenses. You can also pass an address:port of a floating license server; when configuring an installation using a floating license. `squishconfig` will then attempt to contact the license server to verify its compatibility with your installation.
`--python=<PATH>`	Specifies which Python interpreter to use when executing Squish tests written in Python. For more details please refer to Switching Python interpreters
`--java=<PATH>`	Relevant for testing Java applications or Java applets. Defines the path to the Java Runtime Environment (JRE) used by the application to test.
`--swt=<PATH>`	Relevant for testing Java/SWT applications. Specifies the path to the `swt.jar` file.
`--support-applets`	Relevant for testing Web applications. Defines, whether automation of Java applets into web pages is supported or not. This option needs to be specified together with –java to have an effect.
`--qt=<PATH>`	Relevant for testing Qt applications on macOS. Specifies the path to the Qt library used by the application.

Switching Python interpreters

Supported Python versions:

2.7
3.8 on Windows
3.9 - 3.12

Important notes:

The architecture of squishconfig and Python must match (i.e., both must be either 32-bit or 64-bit, depending on the Squish package)
Python builds should have their debug, threading and wide-character options at their default values
On macOS:
- Python from python.org is known to work
- Python from Homebrew on Intel machines is known to work
- Python from Xcode is not supported
On Windows:
- Python from python.org is known to work
- Python from Microsoft Store is not compatible with Squish due to path restrictions

Installer squishide

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.
The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.
Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.