Installation

Coco Installation

Download the appropriate package for your platform from the Qt Customer Portal. See Coco Packages for a guide on picking the appropriate package for your platform.

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.
Alternatively, you can also use the cocosetup program to configure compilers and toolchains. This must then be done after Coco was installed.

The way the installer must be executed differs per platform:

Microsoft^® Windows: The installer is an .exe file and must be executed.
Linux™: The installer is a .run file and must be executed with bash, as in
```
$ bash SquishCocoSetup_3.3.2_Linux_x86_64.run
```
macOS: The installation package is a .pkg file. Click it and the installer will be started.

Unattended Installation

See Installation of Coco without user interaction.

Licenses

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 (QLS) 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 and legacy operating systems

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.

The same approach is required for a current Coco version running on a legacy operating system, since the installer packages for those systems don't include the License Service either. See Legacy packages and cocolicserver.

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.

Coco Packages Tutorials

Coco v7.6.0 ©2026 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.