From now on, you will need Java 25 to run the nightly and sprint releases of Axon Ivy 14.0.
We recommend to install Eclipse Temurin.
VS Code Extension
The Axon Ivy PRO Designer 14 VS Code Extension backend and the Java Language Server must also be started with Java 25. Per default our plugin makes this setting if we can find Java 25. Otherwise, make sure that you set the java.jdt.ls.java.home setting to a Java 25 JDK.
If this is not set, the Java Language Server uses the bundled Java 21 JRE instead, which does not work.
Local usage
Make sure that Java SE 25 and Maven 3 are installed on your machine.
We recommend to install Eclipse Temurin
Dev Container
Make sure that Java SE 25 and Maven 3 are installed on the devcontainer.
The devcontainer.json should look like our devcontainer template.
Run Axon Ivy Engine
Java SE 25 Eclipse Temurin is already included in our Windows installation and the Docker container.
On Linux, we do not include Java SE 25. We recommend to install Eclipse Temurin.
If the Java version is incorrect, the Axon Ivy Engine will not start and will display the following error message:
JVM must have version 25 or greater (using '/usr/lib/jvm/java-21-temurin/bin/java' from 'JAVA_HOME=/usr/lib/jvm/java-21-temurin'), but has version 21.
Either install a JVM with version 25 in your PATH or set the JAVA_HOME environment variable to point to a JVM with version 25.
Maven Build
Make sure that Java SE 25 and Maven 3 are used for the build. We recommend the following Docker image: maven:3.9.12-eclipse-temurin-25.
If you try to build an Axon Ivy 14.0 project using Java 21, you will encounter this exception:
Execution default-ivy-cleanup of goal com.axonivy.ivy.ci:project-build-plugin:14.0.0-SNAPSHOT:ivy-cleanup failed:
Unable to load the mojo 'ivy-cleanup' in the plugin 'com.axonivy.ivy.ci:project-build-plugin:14.0.0-SNAPSHOT' due to an API incompatibility:
org.codehaus.plexus.component.repository.exception.ComponentLookupException: ch/ivyteam/ivy/maven/CleanupMojo has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0
It will complain that the project-build-plugin Maven plugin was built with Java 25 (class file version 69.0), whereas the current Java version only supports up to class file version 65.0 (Java 21).
