Uninstalling on-prem clients on Windows
To ensure a clean removal of Celonis on-premise clients (OPC) and prevent orphaned services or corrupted configurations, it is critical to use the same method for uninstallation that was used for the initial deployment. Whether you used the graphical Management Tool, a custom script, or a manual file placement, following the corresponding procedure below will ensure that all Windows services are properly stopped and all local data is purged.
Before removing the software package itself, you must decommission the background services. This prevents the Windows Service Control Manager from retaining "ghost" entries that can interfere with future reinstalls.
Launch the tool: Open the On-prem Client Management Tool.
Stop and Remove Automation Agent: Navigate to the Automation Agent tab.
Click Stop to terminate the process.
Click Uninstall to remove the service entry from Windows.
Stop and Remove SAP Extractor:
Navigate to the SAP Extractor tab.
Click Stop, then click Uninstall.
Cleanup: Once the tool confirms the services are removed, you can safely delete the remaining files from the installation folder.
If you used a custom script or enabled SNC (Secure Network Communications), you must use the SC command to manually stop and delete the service entries.
Warning
If the SC STOP command fails or hangs, ensure you do not have any active log files open in another application, as this may prevent the service from shutting down gracefully.
Open Terminal: Launch the Command Prompt (CMD) as an Administrator.
Remove Automation Agent: Run the following commands:
SC STOP celonis-automation-agent-with-snc SC DELETE celonis-automation-agent-with-snc
Remove SAP Extractor: Run the following commands:
SC STOP celonis-extraction-agent-with-snc SC DELETE celonis-extraction-agent-with-snc
Once the Windows services have been decommissioned, you can proceed to remove the application files. The method you use depends on how the client was initially deployed.
Note
If you are unsure which method was used, check the Apps & Features list in Windows Settings. If "Celonis On-Prem Client" appears in the list, use Method A.
If you originally used the .msi or .exe installer, you should use the same utility to perform a clean registration removal.
Run the installer: Execute the same installation file used for the initial setup.
Select uninstall: When the wizard detects the existing installation, select the Remove or Uninstall option.
Verify removal: Follow the on-screen prompts until the wizard confirms the package has been removed from the system registry.
Final cleanup: Manually delete the installation directory (e.g., C:\Program Files\Celonis\) to remove any remaining log files or temporary configurations.
If you deployed the OPC by manually extracting a ZIP archive or copying a folder, there is no system registry entry to clear.
Delete Files: Simply delete the entire folder containing the OPC binaries and configuration files.
Check User Profiles: Ensure that any local application data stored in
%APPDATA%(if applicable) is also removed to prevent configuration carry-over during future installs.