# Compilation and installation

"levolution" is only distributed as source code, but it will be easy for you to compile and run the program on all Unix systems and with not that much additional work also on Windows. Here we will show you how.

## Step 1: Obtaining the source code

"levolution" is hosted on bitbucket and can be cloned with the command:

git clone --depth 1 https://WegmannLab@bitbucket.org/WegmannLab/levolution.git


If you already have cloned the repo but would like to update to a newer version, simply use

git pull


Alternative, the source can also be downloaded as a zipped folder. This folder contains the latest C++ source code of levolution as well as the sub folder "examples" containing some example files. (See [downloads page](https://bitbucket.org/wegmannlab/levolution/downloads) for more options).

## Step 2: Compiling the code

After unzipping or cloning, the code must be compiled to obtain an executable. It is recommended to use the GNU C++ compiler g++, which is part of the GCC package and is pre-installed on any Linux system. On a Mac, g++ can be installed as part of the developer tools. On windows, it is advised to use the g++ compiler that ships with cygwin.

To compile levolution, simply type the following command in the base folder:

g++ -O3 -o levolution *.cpp

That's it! "levolution" is now ready to use.

## Step 3: Launching levolution

To launch levolution from within the source base folder, type:

./levolution


If you want to call levolution from a different folder, you must specify the absolute path to it. It can thus be convenient to copy the executable somewhere else or to add the source folder to your \$PATH variable (search on Google for more advice).

## What's next?:

Check out how to launch and use levolution

Updated