sudo apt install git
Installing MidPoint From 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 distribution package or containers much easier.
MidPoint 4.0 and later
This guide applies to midPoint 4.0 and later. For guides that apply to older releases please see the release notes.
Before You Start
There are few things to check before you start the installation:
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.
Make sure the System Requirements are met.
Development versions of midPoint are, quite obviously, not finished yet. There may be unfinished parts, bugs, instability and a variety of other problems. Use it at your own risk only.
MidPoint is a Java application, therefore it requires Java platform to run on. Java 21 is a recommended platform for MidPoint 4.8.2. Alternatively, Java 17 can be used. Other Java platform versions are not supported. Java platform distributions based on OpenJDK are recommended. Other JDK builds (e.g. Oracle) may work as well, but those have limited support for midPoint (see release notes for the details).
JAVA_HOME environment variable should point to the Java installation path.
Please make sure you have full Java Development Kit (JDK), not just the runtime environment (JRE). Full set of development tools is needed, as you will be building midPoint from source code.
The midPoint source is available from a Git server.
You will need a suitable git client software to clone the source code.
Many operating systems include that as a standard package.
E.g. Debian-based Linux system can install it using
Getting The Source Code
MidPoint source code is hosted on GitHub:
GitHub project page
Git repository HTTPS access
Git repository SSH access
Use your git client to clone the source code tree.
For example, Linux system can use
git command-line client:
git clone -b v4.8.2 https://github.com/Evolveum/midpoint.git
Running this command creates
midpoint directory containing midPoint source code tree.
-b option specifies midPoint version.
You can ommit the option to get the latest development version of midPoint (
git clone https://github.com/Evolveum/midpoint.git
For more information about the source repository structure see Source Code.
On Windows, we highly recommend to add the following switch to the
Actually, you can use the switch on any platform.
While in theory
Next to master branch there are available also support branches. After each release there is ready relevant support branch where are placed all the bug fixes until next release is done. It is working snapshot between releases.
These branches have the naming support-X.Y. E.g. for the LTS release 4.8(.x) there is support branch support-4.8.
Enter the directory with downloaded source code and execute either of the following commands:
Complete build process also includes unit and integration tests, and it may take more than one 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
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
Please note the minus character (-) before profile name.
Continue with installation in the same way as for a binary release.
See Installing MidPoint Server From Distribution Package page.
However, you need to use your own freshly built distribution package from
dist/target directory instead of downloading it.
MidPoint is a comprehensive system, and the source code is quite big. If you plan to work with midPoint source code, we strongly recommend getting an integrated development environment (IDE). Most midPoint developers are using IntelliJ IDEA and there is a short guide to set up IntelliJ IDEA for midPoint development. Eclipse Java IDE can also be used.
MidPoint is using embedded H2 database by default to store its data. The embedded H2 database is find for first steps with midPoint, demo environments, development and similar non-production purposes. It is not supported for any pre-production and production use. PostgreSQL database has to be used for any serious midPoint deployment. Please see native PostgreSQL repository page for installation details.