MidPoint Home Directory is a filesystem directory that provides a home to midPoint installation. It is a directory that midPoint uses to store initial configuration, cryptographic keys, log files and similar "variable" content. midpoint.home . Those are data that are not well suited for identity repository (database). Initial configuration, log files, connector JAR files, schema customizations and other such low-level entities can be found in the midpoint.home directory.

Setting Location of MidPoint Home Directory

Easiest way to set the location of midpoint home directory is to set MIDPOINT_HOME environment variable before midPoint start script is executed (applies to stand-alone deployment on UNIX systems).

In other cases the midpoint.home directory can be specified by setting the midpoint.home JVM property (hence the name). Setting the property depends on the application server or web container that is used to run midPoint but it is usually a variation of the following JVM command-line option:

Default Setting

The default setting on midPoint home depends on a way how midPoint was deployed.

For stand-alone deployment (which is the default) midPoint home directory is located in var sub-directory of midPoint installation. E.g. if midPoint was installed in /opt/midpoint then midPoint home directory will be located in /opt/midpoint/var. This location is determined by startup shell scripts and explicitly passed to midPoint by using midpoint.home JVM option. For UNIX system the location of midPoint home directory can be easily changed by setting MIDPOINT_HOME environment variable.

For Tomcat deployment the the default setting of midpoint.home is a midpoint subdirectory of the home directory of the user that runs the application server (web container). Therefore it is usually /home/username/midpoint on UNIX systems or \Documents and Settings\username on Windows systems. This is also the case if stand-alone startup scripts were modified and the midpoint.home option is not provided at startup.

MidPoint will try to create the midpoint.home directory if it does not already exist and midPoint has the rights to do so.