--- title: "Installing Process Mining" slug: "installing-process-mining" updated: 2025-10-03T14:17:47Z published: 2025-10-03T14:17:47Z canonical: "documentation.decisions.com/installing-process-mining" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Installing Process Mining ## Overview The following article serves as a walkthrough for installing and troubleshooting **Decisions Process Mining.** Breaking ChangesThe Process Mining Module cannot be installed on Decisions v8.14 and below because it is a JSON Module. Installing on versions prior to v8.14 will result in Decisions crashing. In v8.19 and higher, the module does not need to be installed manually. --- ## Prerequistes Users must confirm that all [Process Mining Requirements](https://documentation.decisions.com/process-mining/docs/process-mining-requirements) are met before attempting installation: - Process Mining is only compatible with Decisions **v8.5 or higher** and requires a **Windows** or **Linux** machine or server. - It is recommended that both Process Mining and Decisions are operating on the **latest version** for optimal compatibility. ## Process Mining via Local Installation 1. Run the **Process Mining Installer** as an Administrator. Running as a non-administrator prevents creating Process Mining files in the Program Files folder. Select **Next** to begin. 2. Select **I accept the terms of the license agreement**, then select **Next** to proceed. 3. Select the **Installation Path** for Process Mining by typing into the field provided or selecting **Browse** and navigating to the desired folder.  The default file install path created is: **C:/Program Files/Decisions/Process Mining.** Confirm the directory location and select **Next.** If selecting a pre-existing installation path, a validation window appears to confirm the possibility of overwriting the old files. Select **Yes** to confirm this location.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/file%20path.png) 4. Configure the following Process Mining application settings: | **Setting Name** | **Example Selection** | **Function** | | --- | --- | --- | | PC or Server Installation Type | Server | Server allows more RAM consumption due to multiple users accessing the Process Mining instance. It is recommended to configure Process Mining as a service to reduce downtime. PC limits RAM consumption, thus is best selected for local environments (single user access). | | Amount of Platform Memory (GB) | 7 | Prompts for amount of RAM (GB) to allocate to the platform. Server type installations are more demanding than PC. By default, this option populates with half of the available RAM (GB) on the machine or all of the RAM minus 1GB if the machine contains equal to or less than 8GB of total RAM. This may be changed after installation to remove any unforeseen lag. Not giving Process Mining enough RAM may cause imports to fail. | | Platform Hostname | Localhost (default) | Prompts for the Hostname for Process Mining. The Hostname between Process Mining and a Decisions Server do not need to match to operate together. | | Platform Port | 8090 (default) | Prompts for the Port that Process Mining will use. Ensure this Port is not occupied by other services by executing **netstat -ano** in a command prompt window. | | Enable a Security Certificate (HTTPS) | No (default) | The Installer has been updated to allow HTTPS during installation for advanced Users. We recommend installing on an open HTTP port during the first setup and then setting up HTTPS after licensing is completed. **If this is your first time installing Process Mining, it is not recommended to add a certificate at this point.** | The combination of **H****ostname** and **P****ort Number** comprise the **Process Mining URL.** Based on this example, the URL would be **http://localhost:8090.** Select **Next** to proceed. Users may receive a Java popup, simply select **"Allow"** to proceed.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h00_37.png) 5. Configure Process Mining to operate along with the main Decisions platform: 1. Set the Dropdown to **Yes.** 2. Set the **Decisions Installation Folder** by typing into the field provided or selecting **Browse** to navigate to the desired folder. Decisions default install directory is **C:\Program Files\Decisions\** 3. Users have the option to specify the latest password for the Mining Agent by selecting **Yes** in the Dropdown. If the Mining Agent's password has not changed, the default password here should work; However, if Process Mining is being installed on a Decisions Production instance, Users are strongly recommended to change this Password before turning on Process Mining. 4. For more information on changing the password for the Mining Agent, please visit [Process Mining Settings](https://documentation.decisions.com/process-mining/docs/process-mining-settings?highlight=password). ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h22_35.png) 5. Specify the **Decisions Platform Base URL** found in the **Settings.xml** file or the **System Information** dialog **(ex: http://localhost:8080)** ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20111258.png) 6. The **Decisions Platform Base URL** needs to include the instance name. Sample URL: **http://localhost:8080/Primary** 7. Select **Next** to proceed.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h26_42.png) 6. Toggle whether the **Process Mining.bat** file will automatically run at startup. If checked, the Process Mining task will be installed in the Windows Task Scheduler, which will run the Process Mining task that starts the service at Startup. Enabling this removes the need to start Process Mining as a service. Select **Next** to proceed. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h31_09(1).png) 7. Installation of Process Mining is underway with the specified configurations. Once complete, the download bars display **[Finished].** Select **Next** to proceed. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h33_34.png) 8. The Installer presents the option to create a **Windows Start-Menu** shortcut.  Make the desired selection and click **Next** to proceed.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/shortcuts.png) 9. Users will need to upgrade the **Process Mining Module** using the **"Decisions.ProcessMining.zip"** located under the **DecisionsModule** directory. For info on how to upgrade the Module please visit our documentation on [Updating Custom Modules](https://documentation.decisions.com/v8/docs/en/updating-custom-modules?highlight=undefined). Please note that this will not work for Decisions v8.14 or earlier. Select **Next** to continue. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1711131519258.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20142128(2).png)The Installer will confirm the successful installation of Process Mining. Click **Done**to exit the Installer. Note before Starting Process MiningBefore running Process Mining, the Decisions Server must be properly configured for Process Mining (see [**Decisions Server Configuration**](/process-mining/docs/installing-process-mining#decisions-server-configuration)). 10. Start Process Mining and Activate Licensing: For first-time installs, it is recommended to run the Process Mining.bat file at the default location: **C:\Program Files\Decisions\Process Mining\DecisionsProcessMining.bat** as an Admin. This action will populate a window, alerting you that the file is running. If Run at Startup is set to False, start the **DecisionsProcessMining.bat** found in the Process Mining Folder before opening the **Process Mining URL**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_10h48_26.png)From here, navigate to the website mentioned and fill in the correct licensing information. After a license has been obtained, Process Mining should restart automatically and be accessible within the browser. Users should use an Admin account from Decisions to log in. 11. [Configure Process Mining Settings](https://documentation.decisions.com/process-mining/docs/navigating-to-process-mining#configuring-process-mining-settings). 12. **Delete** the executable downloaded, then **delete** it from the Recycle Bin. --- ## Staring Process Mining Manually 1. Go to the folder where Process Mining was installed. By default, this is **C:\Program Files\Decisions\Process Mining.** 2. Run DecisionsProcessMining.bat as an administrator. Wait for the pop-up and message telling you to go to the correct address. 3. The licensing window will appear. **![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20142538.png)** --- ### Stopping Process Mining Users should follow these steps to properly stop Process Mining depending on how it was run. 1. If **DecisionsProcessMining.bat** was run, click **Stop Decisions Process Mining** and wait for it to stop running. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_11h46_25(2).png) 2. If Process Mining is **running as a service**, run **StopDecisionsProcessMining.bat** as an Admin from the Process Mining Folder and wait for it to stop running. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-04-22_12h18_39.png) 3. Navigate to the **Task Manager** and stop all instances of **java.exe**. --- ### Local Installation of SSL Certificate - Place the certificate inside the folder **“$DecisionsProcessMiningFolder$/ipa”.** Open the **“application.properties”** file and edit the following  properties (when using an SSL certificate the only allowed ports are **443** or **8443**): - **server.port=8443** - **server.ssl.enabled=true** - **server.ssl.key-alias={keystore_alias}** - **server.ssl.key-store=data/{keystore_name}** - **server.ssl.key-store-password={keystore_password}** - After applying the changes, restart the Process Mining platform. --- ## Decisions Server Configuration Process Mining RequirementsProcess Mining requires whitelisting the machine's IP Address. To do so, open the **Setting.xml** of the main Decisions instance, update the following setting, Save, and restart Services/IIS App Pool: **[IP Address of Process Mining Machine]** If the IP Address changes, update it here then restart the Decisions Server. 1. For installations operating alongside a Decisions instance, login to the **Decisions Studio** and configure the platform to access Process Mining via **System > Settings > Process Mining Settings.** 2. Selecting the **Enable Process Mining** checkbox will set it to **True**, the **Process Mining URL** is configured in step four, and the **Groups Allowed to Access Process Mining** will be set to **Administrators** by default. Once the selections are configured, click **SAVE.** 3. Launch Process Mining via **WorkFlow Catalog** link, then login with a local account within the group set above. Note: SSO accounts are currently not supported. 4. For standalone installations, open Process Mining by navigating directly to the **Process Mining URL.** --- ## Running Process Mining as A Background Service 1. Once the Licensing is complete, navigate to the **Task Scheduler** application. Select the **DecisionsProcessMining** option and configure the settings. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20143253.png) 1. In the **Triggers** section, select **Edit** to edit the Trigger. Make sure it is set to **At Startup.** Once this is configured, select **OK** to continue. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image%20(3)(1).png) 2. In the **Settings** section, make sure the **"Allow task to be run on demand"** and **"If the running task does not end when requested, force it to stop"** options are checked and **"Stop the task if it runs longer than"** option is left unchecked (if this option is checked, Process Mining will stop after three days). Then click **OK.** ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1711637111204.png) 2. Once the settings have been configured, right-click on **DecisionsProcessMining** and click **Run.** ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20143344.png) To stop the service from starting on system start go to the installation folder for Process Mining (by default this is C:\Program Files\Decisions\Process Mining) and run StopDecisionsProcessMining.bat as an administrator. Please note that despite its name, the StopDecisionsProcessMining.bat file does not stop an actively running instance of Process Mining. --- ## Licensing In order to activate a valid license for Decisions Process Mining, first navigate to the **Process Mining URL.** Select the **License** button and the select either **Activate Trial License** or **Activate License** from the popup. **![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20142538.png)** For a **Trial License**, the user will simply fill out the **Name** and **Email Address** fields and then click **ACTIVATE TRIAL LICENSE.** The Name should be the company name, and email is the user's business email address. Once this is complete, the user will then have a Trial License for Decisions that will last for 14 days. After the 14 days ends a new license will need to be used to reactivate Process Mining. If Process Mining is no longer desired, it can be uninstalled at this point without impact on the Decisions platform. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20142603.png) To obtain a regular **Decisions License**, the user will fill out the **Name, Email Address,** and **Phone Number** fields. The user can reach out to [support@decisions.com](mailto:support@decisions.com) to obtain their **Customer Id.** Once the fields are complete, click **ACTIVATE.** ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20142649.png) --- ## Configure SSL (HTTPS) ### Prerequisites - [Create a PKCS12 certificate using OpenSSL.](https://www.openssl.org/docs/man1.0.2/man1/pkcs12.html) - **Example:** sudo openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out keystore.p12 -name CertName -CAfile chain.pem -caname root -password pass:CertPassword | **Field** | **Description** | | --- | --- | | privkey.pem | The private key for your certificate. | | fullchain.pem | The certificate file used in most server software. | | chain.pem | Used for OCSP stapling in Nginx >=1.3.7. | | keystore.p12 | The keystore in PKCS12 format containing the certificate. | | CertName | The alias of the keystore. | | CertPassword | The password of the keystore. | --- ## Troubleshooting If any problems occur, users can download Error Logs from two different locations. The two locations are the default location **C:\Program Files\Decisions\ipa\data\logs** and from the **Process Mining URL** by clicking the gear icon on the top right of the page and selecting **Download Error Logs.** The user can then send those Error Logs to [support@decisions.com](mailto:support@decisions.com) for assistance. For more troubleshooting techniques see [Troubleshooting Process Mining](https://documentation.decisions.com/process-mining/docs/troubleshooting-process-mining). ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Screenshot%202024-03-22%20143549.png) --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | HTTPS can now be enabled during the installation process. | [3.1](https://documentation.decisions.com/v99/docs/en/pm-version-3x1?highlight=DT-040674) | July 2024 | [DT-040674] | | Users can now set up their password during the installation process. | [3.1](https://documentation.decisions.com/v99/docs/en/pm-version-3x1?highlight=DT-040815) | July 2024 | [DT-040815] | | Users can now run Process Mining on Linux and Windows. | [3.7](https://documentation.decisions.com/v99/docs/version-37-release-notes?highlight=DT-045057) | September 2025 | [DT-045057] |