Page tree
Skip to end of metadata
Go to start of metadata

Source Code

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

Release Notes

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 SE Development Kit 7

The development environment requires at least JDK 7 which can be downloaded at  

JAVA_HOME environment variable should point to the JDK installation path.

Please note that Java 6 platform is no longer supported (although it might work in some situations)

Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 7

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 After downloading zip file follow installation instructions written in README.txt

Apache Tomcat

midPoint needs an application server. Currently, Apache Tomcat 6.x or 7.x is supported. More application servers will be supported in later releases.

Apache Tomcat can be downloaded from The Apache Tomcat installation directory is further referenced as <tomcat>. In windows platform prefer downloading of zip file to downloading of windows installer as later do not populate bin directory with all batch files. You will start tomcat server via running the startup.bat file from <tomcat>\bin directory.


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.


Download and install Maven3:

M2_HOME environment variable should point to the Maven installation path.

Please note that there are some issues with Maven 2 build. Maven 3 build is strongly recommended.

Prepare midPoint software

Get midPoint

Get the source from our Git repository

git clone -b v2.2 git://

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:

mvn install

Complete build process also includes unit and integration tests and takes approx. 1 hour.

You can speed up the build by skipping automatic tests using the following command:

mvn install -DskipTests=true

After the successful build process there will be a binary distribution package located in dist/target directory.

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 gui/admin-gui/target/midpoint.war

The build process has been tested with Maven 3. Please note that there are some issues with Maven 2 build. Maven 3 build is strongly recommended.

Deploy midPoint

What Now?

For an quick introduction to use of midPoint please follow the instructions on First Steps page. Full Administration Interface is also available.

See Also

  • No labels