Installing MidPoint 4.0.1 "Gutenberg" Update 1 From Binary Distribution

Last modified 22 Apr 2021 17:31 +02:00


This page describes the steps required to install midPoint 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. Java 11 is a recommended platform for MidPoint 4.0.1. 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).

MidPoint 4.0.1 may run on Java 8 platform. 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 lifetime of this release is over.

JAVA_HOME environment variable should point to the Java installation path.


Download the midPoint binary release according to the following table:

MidPoint 4.0.1 Binary Distribution

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:





User dashboard should be displayed after login. In case of any problems, please check midPoint logs in var/log/ directory.

What To Do Next?

For a quick introduction to use of midPoint please follow the Quick Start Guide or read through the midPoint book to get familiar with midPoint.

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

Was this page helpful?
Thanks for your feedback