In this chapter we will see how to prepare the development environment on Linux operating systems for working with Axelor Open Platform sources.


MySQL 5.x, MariaDB 10.x & are also supported. See configuration section for more details.

Install OpenJDK 8 and make sure JDK command line tools are in your path. If you use distribution provided OpenJDK, they are already available in PATH otherwise do this:

$ export JAVA_HOME=/path/to/jdk
$ export PATH=$JAVA_HOME/bin:$PATH

Install PostgreSQL from your Linux distribution’s package repositories.

For ubuntu, you can do this:

$ sudo apt-get install postgresql


Download the latest distribution package from and extract the package somewhere and set following environment variables.

$ export AXELOR_HOME=/path/to/axelor-adk
$ export PATH=$AXELOR_HOME/bin:$PATH

or you can build from the latest source like this:

$ git clone
$ cd axelor-development-kit
$ ./gradlew installDist
$ export AXELOR_HOME=/path/to/axelor-development-kit/build/install/axelor-development-kit
$ export PATH=$AXELOR_HOME/bin:$PATH

You should have a special command `axelor' in your path now. Just try issuing following command on the terminal:

$ axelor --help

You should see output something like this:

Usage: axelor [--help] [--new <NAME>]
Run the interactive shell or create a new axelor project.

  -h, --help          show this help and exit
  -v, --version       display version information
      --new <NAME>    create a new application project

You can also execute shell commands directly like:

$ axelor help
$ axelor help run
$ axelor clean
$ axelor build
$ axelor run -p 8000

The command line utility can also be used in interactive mode where the utility runs in a special shell from where you can issue various commands.