Installing MidPoint 4.8.6 "Curie" - Update 6 From Binary Distribution

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.

MidPoint is a Java application, therefore it requires Java platform to run on. Java 21 is a recommended platform for MidPoint 4.8.6. 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.

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.

If you want to customize administrator initial password before first start see Administrator initial password. By default password is generated.

All that remains is to start midPoint server up:

bin/start.sh

bin\start.bat

If you did not configured initial administrator password, you should search logs (var/log/midpoint.log) for Administrator initial password. The password may contain spaces, so it is enclosed with double qoutes. Do not forget to remove qoutes.

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

http://localhost:8080/midpoint/

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

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.

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.

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