2. Install the Engine (Linux)

We suggest you install the Axon Ivy Engine into a new folder called /opt/ivy/engine. Create the directory and change the owner to your current user.

cd /opt
sudo mkdir ivy
sudo chown myuser:myuser ivy

Replace myuser with the name of your current user.

Tip

Instead of using your current user, we suggest to use a special Linux user called ivy. First, create a new user and a group called ivy. Then, change the owner of the folder ivy to the user ivy. After that, login as user ivy and work with this new user.

sudo mkdir ivy
adduser ivy
...
sudo chown ivy:ivy ivy
ls -al
...
drwxr-xr-x 3 ivy  ivy       4096 Sep 15 11:26 ivy
...
login ivy
...

Download the latest engine:

cd ivy
mkdir engine
cd engine
wget https://developer.axonivy.com/permalink/12.0/axonivy-engine.zip -O engine.zip

Note

We provide Axon Ivy Engine in different packages:

  • Docker Docker Image for all platforms that can run Linux containers.

  • Linux For all platforms (including Windows). It contains launchers for both Windows and Linux. No Java Runtime (JRE) is bundled, thus, you need to install one yourself. Axon Ivy Engine will use the JRE pointed to by the operating system environment variable IVY_JAVA_HOME. If not set, Axon Ivy Engine falls back to the JRE pointed to by JAVA_HOME.

  • Windows The preferable package for Windows. It comes with a bundled Java Runtime; otherwise, it is identical to the Linux package. So, if you want to supply your own JRE, use the Linux package.

To install Axon Ivy Engine, unzip the downloaded file AxonIvyEngine*.zip into a new AxonIvyEngine* folder

unzip engine.zip -d latest
rm engine.zip
cd latest

Note

The most important folders of the Axon Ivy Engine are:

  • bin folder which contains all the executables.

  • configuration folder which contains the configuration files.

  • deploy folder which is used to deploy Axon Ivy projects.