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


This page describes the steps required to install midPoint Identity and Access Management from a binary distribution. MidPoint is a Java web application distributed in a form of a stand-alone self-contained server. All that is essentially needed is to unpack the distribution archive and run the server.

This document describes the generic case suitable for trying out midPoint. For more complex installation scenarios please see Installation Guide.

Release Notes

Before you start the installation 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.


MidPoint is a Java application therefore it requires Java platform to run on. Recommended java platform is OpenJDK 11.

JAVA_HOME environment variable should point to the Java installation path.

Java platform versions

Java 11 is a recommended platform. Java platform distributions based on OpenJDK are recommended. Oracle JDK builds may work as well, but those have limited support for midPoint (see release notes for the details).

MidPoint 4.0 will run on Java 8, however Java 8 support is deprecated. If you choose to use Java 8 it is strongly recommended to migrate to Java 11 soon. As the situation with free updates to Oracle Java platform is not clear support for Java 8 may be removed even before the midPoint 4.0.x lifetime is over.

Download MidPoint

Download the midPoint binary release according to the following table:

Unpack the archive file to a convenient location. Following instructions will refer to the relative paths inside this archive.

Start MidPoint

All that remains is to start midPoint server up:

Starting midPoint (Linux)
Starting midPoint (Windows)

Try MidPoint

Log in to the midPoint administration console using the following URL:






A home page of the midPoint console should be displayed.

If there is a problem, please check midPoint logs in var/log/ directory.

What To Do Next?

For an quick introduction to use of midPoint please follow the instructions on First Steps page or read through the midPoint book to get familiar with midPoint. Full administration interface guide is also available.

The Stand-Alone Deployment page describes layout of the installation directory.

See Also

  • No labels