Installation

Getting Started

This chapter describes the installation and setup of Coco on your machine.

Note: Before installing Coco, make sure that all of the compilers you wish to use are already installed. The Coco installer scans your hard drive (using locate on Unix systems) for compilers and installs additional files (wrappers and .cspro files) for some of them only if they are found at install-time. Reinstall Coco after installing a new compiler.

Coco Installation

An installer for Coco can be downloaded from your Qt Account Download area https://account.qt.io/s/downloads.

The installers for the various platforms supported by Coco have a common naming scheme, but the way they must be executed differs. The naming scheme is SquishCocoSetup_<x.y.z><platform>.<suffix>, where <x.y.z> is the program version, <platform> describes the operating system and other details of the installation, and <suffix> is an operating system specific suffix.

Microsoft^® Windows: The installer is a file SquishCocoSetup_<x.y.z>_Windows_x86.exe or SquishCocoSetup_<x.y.z>_Windows_x64.exe and must be executed.
Linux™: The installer is a file SquishCocoSetup_<x.y.z>_<platform>.run and must be executed with bash, as in
```
$ bash SquishCocoSetup_3.3.2_Linux_x86_64.run
```
Note that the CentOS version of the installer is also valid for RedHat Linux™.
macOS: The installation package is a file of the form SquishCocoSetup_x.y.z_<platform>.pkg. Click it and the installer will be started.

Unattended Installation

See Installation of Coco without user interaction.

License Server Setup

Since version 7.4.0, Coco acquires its licenses from the Qt License Server. The cloud instance of the Qt License Server at https://qls.qt.io is used by default.

If you want to self-host an on-premise Qt License Server, you can find more information on the following documentation pages:

License Service Setup

After the installer is run, the license service needs to be set up. This can be quickly done by running:

$ cocolic --setup-qls

To verify that the license service is set up correctly, run:

$ cocolic --check

For other ways to setup the license service, see The Qt License Service documentation page.

Using QLS on earlier Coco versions

Coco versions older than 7.4.0 can also be used with QLS, but you will need to run a special version of cocolicserver that converts the new QLS license to the old license format. The details are in the section about Running cocolicserver as a QLS proxy.

Updates

To update to a newer version of Coco, download and install it. It will then overwrite the previous version.

If a new compiler is installed, then the Coco installer should be run again, so that Coco becomes aware of the new compiler. This includes new versions of Microsoft^® Visual Studio^®. If Visual Studio 2013 was present during the Coco installation and Visual Studio 2015 is added, the Coco installer needs to be run.

If instead the compiler is updated, Coco should work mostly without changes.

Note: One exception is the C# compiler. If it is updated, the Coco setup will be overwritten and Coco needs to be reinstalled to make code coverage work again.

Test Data Generation Tutorials

Coco v7.5.0 ©2025 The Qt Company Ltd.
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.