Leosac  0.7.0
Docker: Cross Compiling Container

Describes how to use the "cross_compile" helper container.

Leosac comes with a container tailored for cross compiling Leosac to RaspberryPi. The process of cross-compilation bundles dependencies and build them.


The cross_compile container needs some pre-packaged dependencies that it will rebuilt. Those are hosted at http://github.com/leosac/bin-resources

Clone http://github.com/leosac/bin-resource and move its cross-compile-resources folder in the the root of Leosac repository.

Then the container must be built. Building the container does not build Leosac. Instead it builds and install dependencies and required toolchain.

You must first build the "cross_compile" container before cross-compiling Leosac. The easiest way to do that is: leosaccli dev docker build cross_compile.

How it works

When building the container, required library are built and installed into /opt/rpi_fakeroot in the container.

Running the container will build an ARM version Leosac. For this, the container expects two or three volumes:

  • /leosac : the root of the Leosac repository (read-only).
  • /leosac_arm_build : Build output directory (read-write).
  • /ssh_deploy_key : An optional volume that points to a valid ssh private key. This is used by command leosaccli dev cc dev-push command.

The build will take place in /leosac_arm_build.

How to use

The recommended way to interact with the cross-compile container is to use leosaccli dev cc XXX.

Run leosaccli dev cc --help to see what you can do.


Run the following:

  • leosaccli dev cc cmake
  • leosaccli dev cc fakeroot-package
  • leosaccli dev cc make
  • leosaccli dev cc package

This will give you a fakeroot.tar that you should extract on your RaspberryPi (at /opt/rpi_fakeroot). Similarly, you should upload your LEOSAC-x.y.x.sh and install it on the raspberry.

You must extract fakeroot.tar to /opt/rpi_fakeroot. The easiest way to do this is by running untar fakeroot.tar -C /