Building the S2E Platform

S2E builds and runs on Ubuntu 14.04, 16.04 and 18.04 (64-bit).

Building with s2e-env

The simplest way to build S2E is to use the s2e-env tool. It is the preferred method for development. See Using s2e-env for instructions.

If you want to build S2E using Docker or manually, read below.

Building using Docker

You can create a self-contained docker image that lets you analyze any supported binary. The following command builds the demo docker image.

# Checkout S2E sources (using Google Repo)
# S2EDIR must be in your home folder (e.g., /home/user/s2e)
cd $S2EDIR
repo init -u
repo sync

# Create a build directory
mkdir build && cd build

# Build the docker image
make -f $S2EDIR/Makefile.docker demo

You can then run it as follows:

docker run --rm -ti -w $(pwd) -v $HOME:$HOME cyberhaven/s2e-demo /demo/ $(id -u) $(id -g) /demo/CADET_00001

This command starts the s2e-demo container and creates an S2E environment in $(pwd)/s2e-demo. It then downloads a VM image and creates a default S2E configuration suitable for running the specified binary. Once configuration is done, the container starts S2E.

The S2E environment in $(pwd)/s2e-demo is persistent. It is not kept in the container. You may run the container multiple times without losing the previous settings. This is possible by mounting your home folder in the container. The command also takes your current user and group id in order to create the environment folder with the right permissions (docker uses root by default).

You may specify any binary you want and are not restricted to binaries stored inside the container. You just need to mount the folder that contains it using the -v option.

Building S2E manually

In addition to using the s2e-env tool, you can also build S2E manually.

NOTE: If you are using Ubuntu 14.04 you must install CMake manually - S2E requires version 3.4.3 or newer, which is not available in the Ubuntu 14.04 repositories.

Required packages

# Build dependencies
sudo apt-get install build-essential
sudo apt-get install cmake
sudo apt-get install wget
sudo apt-get install git
sudo apt-get install texinfo
sudo apt-get install flex
sudo apt-get install bison
sudo apt-get install python-dev

# S2E dependencies
sudo apt-get install libdwarf-dev
sudo apt-get install libelf-dev
sudo apt-get install libboost-dev
sudo apt-get install zlib1g-dev
sudo apt-get install libjemalloc-dev
sudo apt-get install nasm
sudo apt-get install pkg-config
sudo apt-get install libmemcached-dev
sudo apt-get install libvdeplug-dev
sudo apt-get install libpq-dev
sudo apt-get install libc6-dev-i386
sudo apt-get install libboost-system-dev
sudo apt-get install libboost-serialization-dev
sudo apt-get install libboost-regex-dev
sudo apt-get install libprotobuf-dev
sudo apt-get install protobuf-compiler
sudo apt-get install libbsd-dev
sudo apt-get install libglib2.0-dev
sudo apt-get install python-docutils

# S2E image build dependencies
sudo apt-get install libguestfs-tools
sudo apt-get install genisoimage
sudo apt-get install python-pip
sudo apt-get install xz-utils
sudo apt-get install
sudo apt-get install p7zip-full
sudo apt-get install pxz
sudo apt-get install fuse
sudo apt-get install libhivex-bin
sudo apt-get install jigdo-file

The following commands ask apt-get to install build dependencies for qemu:

sudo apt-get build-dep qemu

If you are going to be analyzing Windows binaries, you will also need to install mingw to compile the guest tools:

sudo apt-get install mingw-w64

Checking out S2E

S2E source code can be obtained from the S2E git repository using the following commands. Here $S2EDIR is the directory that will hold both the S2E source and build directories.

cd $S2EDIR
repo init -u
repo sync

This will setup the S2E repositories in $S2EDIR.

In order to contribute to S2E (e.g., submit new features or report bugs), please see here.


The S2E Makefile can be run as follows:

mkdir $S2EDIR/build
cd $S2EDIR/build
make -f $S2EDIR/Makefile install

# Go make some coffee, this will take some time (approx. 60 mins on a 4-core machine)

By default, the make command compiles and installs S2E in release mode to $S2EDIR/build/opt. To change this location, set the S2E_PREFIX environment variable when running make.

To compile S2E in Debug mode, use make install-debug.

Note that the Makefile automatically uses the maximum number of available processors in order to speed up compilation.


You can use the same Makefile to recompile S2E either when changing it yourself or when pulling new versions through repo sync. Note that the Makefile will not automatically reconfigure the packages; for deep changes you might need to either start from scratch by issuing make clean or to force the reconfiguration of specific modules by deleting the corresponding files from the stamps subdirectory.

Building the documentation

The S2E documentation is written in reStructuredText format. HTML documentation can be built as follows:

$ sudo apt-get install linkchecker
$ pip install sphinx_rtd_theme
$ cd $S2EDIR/docs/sphinx
$ ./

The documentation will be located in $S2EDIR/docs/sphinx/build/html/index.html.