Skip to main content

Uninstalling on-prem clients on MacOS

Uninstalling the Celonis On-Premise Client on macOS is a straightforward process, but it requires a specific sequence to prevent 'ghost' processes from running in the background. Whether you are migrating to a new machine or troubleshooting a local connection, following these steps will help you stop your services and remove your installation files without leaving behind unnecessary data.

Uninstalling on MacOS

To ensure your system is completely clean, follow this step-by-step procedure:

Step 1: Deactivate services via the Management Tool

Your first priority is to stop the active processes so the files aren't "in use" when you try to delete them.

  1. Launch the Tool: Open your On-prem Client Management Tool application.

  2. Stop the Automation Agent: Navigate to the Automation Agent tab, click Stop, and then click Uninstall.

  3. Stop the SAP Extractor: Switch to the SAP Extractor tab, click Stop, and then click Uninstall.

Step 2: Manual file cleanup

Once the services are deregistered, you need to remove the physical footprint from your drive.

  1. Locate the Folder: Find the directory where you originally extracted the OPC (common locations are ~/Applications/ or a dedicated Celonis folder in your user directory).

  2. Delete the Directory: Drag the entire folder to the Trash and empty it.

  3. Check for Custom Logs: If you configured a custom log path in your application-local.yml file, navigate to that specific folder and delete the log files manually.

Step 3: Verify the cleanup (Optional but Recommended)

To be absolutely certain no Java processes are still hanging around, you can run a quick check in the Terminal:

  1. Check for active processes: Type ps aux | grep -i celonis and press Enter.

  2. What to look for: If you see any active lines (other than the "grep" command itself), a process is still running. You can kill it using: kill -9 <PID>.

Related topics