MidPoint 3.7 and later
This guide provides instruction for installing midPoint from the source code. It requires software development tools and some experience to build the product. This is recommended only for engineers that want to participate in midPoint development or have deeper interest in the source code. Everybody else will probably find installing binary release much easier.
Before You Start
Please make sure to see Release Notes for list of environments that are known to work and for the list of known issues in current release.
Java Development Kit 8
JAVA_HOME environment variable should point to the JDK installation path.
Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8
Optional AES-128 is used by default for encrypt/decrypt operations, so JCE is not needed. If you want to use bigger key size, e.g. AES-256, then JCE is required for cryptographic operations. You can download it at http://www.oracle.com/technetwork/java/javase/downloads/index.html. After downloading zip file follow installation instructions written in README.txt
Java 8 only
MidPoint is supported only on Java 8 platforms. MidPoint supported both Java 7 and Java 8 for several years. The support for Java 7 was deprecated in midPoint 3.4.1 and it was removed in midPoint 3.5.
The midPoint source is available from a Git server. The details regarding Git, Git client software and Git server locations are described in Git page. Short summary of Git coordinates is provided in the following table.
|GitHub project page||https://github.com/Evolveum/midpoint|
|Git Repository URLs|
Download and install Maven3: http://maven.apache.org/download.html
M2_HOME environment variable should point to the Maven installation path.
Prepare MidPoint Software
Get the source from our Git repository
Please use appropriate tag (e.g
v3.7) for current release. To check out the latest development branch skip the -b flag entirelly:
For more information about the source repository structure see Source Code.
Build MidPoint From Sources
Enter the directory with downloaded source code and execute either of the following commands:
Complete build process also includes unit and integration tests and more than one hour. You can speed up the build by skipping automatic tests using the following command:
After the successful build process there will be a binary distribution package located in
Building the WAR file only
If the WAR file is all you need you can speed the build even further by skipping the packaging of the distribution archive. Use the following command to turn off the
dist maven profile:
mvn clean install -DskipTests=true -P -dist
Please note the minus character (-) before profile name.
The resulting WAR file can be obtained from