How to install the Cheerp toolchain on your favourite operating system

The first step to using Cheerp is to install the Cheerp toolchain.

Command Line Notation
Throughout this documentation, we’ll show some commands used in the terminal. Lines that you should enter in a terminal all start with $. You don’t need to type the $ character; it’s the command line prompt shown to indicate the start of each command. Lines that don’t start with $ typically show the output of the previous command.

Installing Cheerp on Linux

Packaging status


Use our PPA:

Terminal window
$ sudo add-apt-repository ppa:leaningtech-dev/cheerp-ppa
$ sudo apt-get update
$ sudo apt-get install cheerp-core


Use our AUR package:

Terminal window
$ yay -S cheerp-git
This might take a while
cheerp-git will compile Cheerp from source. For a faster install, you can use the community-maintained cheerp-bin package which unpacks the Ubuntu package.

Build from source

Users on other Linux distributions must build Cheerp from source.

Installing Cheerp on Windows

Download the latest graphical installer from GitHub and follow the installation wizard. The default installation path is currently the only supported one.

You can also build Cheerp from source if you prefer.

If you are using WSL, follow the instructions for Linux.

Installing Cheerp on macOS

Download the DMG image for macOS from GitHub and install it by opening the image and drag-and-dropping Cheerp into the /Applications directory.

The binary is not signed so you may need to run the following to stop Gatekeeper from blocking the executable:

Terminal window
$ sudo xattr -d /Applications/cheerp/bin/*


To check whether you have installed Cheerp correctly, you can run the following command:

Terminal window
$ /opt/cheerp/bin/clang++ --version

You should see the version of Cheerp that you have installed. If you see something like “no such file or directory”, then Cheerp is not installed correctly.

If you are having any problems, ask for help in the #support channel on our Discord server.

Was this page helpful?
Suggest changes