Preconfigured virtual environment
In order to compile a
JuPedSim package, one needs to install some required packages and libraries, e.g.
boost or even a compiler (
Vagrant can work some magic and help isolating dependencies and their configuration within a single disposable, consistent environment.
Therefore, users, whether they are working on Linux, Mac OS X, or Windows, can compile and run code in the same environment, against the same dependencies, all configured the same way.
To learn more about
Vagrant this page will get you started.
VirtualBox must be installed on its own prior to using
VirtualBox can be installed by downloading a package or installer for your operating system and using standard procedures to install that package.
How it works?
Basically, we will create, configure and distribute an environment where
JuPedSim can be
compiled and run without the necessity to pre-install any dependencies.
Vagrant we can create a
Box that can be used with
VirtualBox or directly by
Once connected to this virtual machine, the user can compile, run, edit or even git push the code.
Download and install Vagrant
Download a binary from the official webpage. The installation is straightforward.
Start out with Vagrant
In the Terminal
mkdir vagrant_test && cd vagrant_test
To start working
vagrant init chraibi/jpscore
This will download an Ubuntu-image for
Vagrant, which contains all packages necessary to work with
The original image's name is ubuntu/trusty64 was modified by installing packages like
Connect to the machine
This will connect you to your virtual machine. See also the following screen-shot
If asked to give a password give
Testing a box
An alternative use of the jpscore-vagrant-image is to get yourself a "box-file" and open it with
Vagrant as follows
vagrant box add my-box /path/to/the/new.box vagrant init my-box vagrant up
A box for
jpscore can be found here.