Download and Start the Server

This procedure assumes that you are starting IDM as a regular (not administrative) user named user.

  1. Download IDM from the ForgeRock BackStage download site. Releases on the ForgeRock BackStage download site are thoroughly validated for ForgeRock customers who run the software in production deployments, and for those who want to try or test a given release.

  2. Extract the contents of the IDM binary file to your user's Downloads directory. The process should unpack the contents to the Downloads/openidm subdirectory.

  3. Navigate to the Downloads/openidm subdirectory:

    • In Microsoft Windows, use Windows Explorer to navigate to the C:\Users\user\Downloads\openidm directory.

      Double-click the getting-started(.bat) file. Do not select the file, as that is intended for use on UNIX/Linux systems.

    • In Linux/UNIX, open a command-line interface and run the following command:

  4. You should see the following message:

    -> OpenIDM ready

When the server is ready, you can administer it from a web browser. To do so, navigate to http://localhost:8080/admin or https://localhost:8443/admin. If you have installed the server on a remote system, substitute that hostname or IP address for localhost.


In production, you should connect to IDM via a secure port and import a CA-signed certificate into the truststore, as discussed in the Security Guide.

Until you install that certificate, you will see a warning in your browser at least the first time you access IDM over a secure port.

The default username and password for the IDM Administrator is openidm-admin and openidm-admin.

When you log in to IDM at a URL with the /admin endpoint, you are logging into the Administrative User Interface, also known as the Admin UI.


The default password for the administrative user, openidm-admin, is openidm-admin. To protect your deployment in production, change this password.

End users can change their password through the End User UI, at http://localhost:8080/ or https://localhost:8443/.

Read a different version of :