Build simulavr


Examples in this chapter refer to a version X.Y.Z, please replace this with your current version, for example 1.1.0!

This chapter describes, how you can build simulavr.


The build scripts with cmake aren’t prepared to work with Windows or Mac OS, even if cmake itself is able to create build configuration for this platforms!

For more informations about special options and other targets please read our manual!


To build simulavr you need:

  • cmake (at least version 3.5 or newer)

  • make

  • gcc (at least a version, which supports c++11)

  • git

  • python (at least version 3.5 or newer)

Of course, docker have to be installed, if you want to build it with docker!

On debian (or also ubuntu) you have to install the following packages:

> apt-get install g++ make cmake git python3

Do the build

The conventional way on linux

At first, you have to clone the repository and change to the cloned repository:

> git clone
> cd simulavr

If you want to produce a dedicated release, you have to change to the release tag:

> git checkout rel-X.Y.Z

Now you are ready to build simulavr:

> make build

After the build was successful without a error, you can find the built program in build/app, shared lib is in build/libsim.

To check, if the program is working, you can start regression test:

> make check