Skip to main content

Celonis Product Documentation

Installing on-prem clients locally

Limited availability

This functionality is currently in limited availability. If you’re interested in trying it out, get in touch with us through

Installing on-prem clients on your own machine can be useful for training or testing purposes. If you’re an Celonis Platform user follow these steps to prepare the installation package with on-prem clients which you can later download for local installation.



We recommend installing the on-prem clients on a central server.

Before you begin

Make sure your system meets hardware and software requirements for clients. See System requirements.


  1. In your Celonis Platform instance, go to Admin & Setting > On-prem clients.

  2. In the upper-right corner, click Set up on-prem clients.

  3. Select Install the clients on your own machine.

  4. Enter a unique package name.

  5. Select the operating system on which you want to install the clients.

    The installer will start downloading automatically.


  1. Install your clients:

    • On Windows:

      1. Extract the ZIP package.

      2. Double-click Celonis_On_Prem_Clients_Installer.exe to run the installer.

      3. Follow the steps of the installation wizard.

      Once the installation is completed, the On-prem Client Management Tool opens.


      If there are already on-prem clients installed in your Celonis Platform instance and you’re installing an additional one, skip this step and run the On-prem Client Management Tool directly from [On-prem client installation folder] > Celonis On-Prem Client Manual Installation > Shared.

    • Linux:

      1. Extract the installation package to the location where you want to install the clients.

      2. In the extracted folder, go to the Shared folder and run OPC-Managmenet-Tool.

      3. In Terminal, go the Shared folder.

      4. Start the On-prem Clients Management Tool. Run:

        sudo ./opc-management-tool-cli
    • On MacOS:

      1. Extract the installation package to the location where you want to install the clients.

      2. To make sure you don't run into any permission-related issues, in Terminal, go to the Shared folder and run:

        xattr -cr


        The -c flag removes all attributes, whereas -r applies recursively for the entire targeted .app directory contents.

      3. From the Shared folder run

  2. (optional) In the Management Tool, generate the encryption key to encrypt sensitive data in the installation package:

    1. Click Generate encryption key.


      Java Simplified Encryption (Jasypt) is used to store and encrypt sensitive data in the application.yml file.

    2. Define a passphrase which will be used to create the hash for the private encryption key.

    3. Click Save.

    This will automatically create the celonis-kms.yml file and encrypt all sensitive data like the application key and the proxy password.


    If you already connected your clients and want to enable encryption retroactively, you must authenticate again for the encryption to be applied.

  3. (optional) Define the proxy server between the on-prem client and the source system or between the on-prem client and the Celonis Platform:

    1. Click Use proxy for communication.

    2. Define the properties of your proxy connection:

      • protocol: http or https

      • host: the IP address or hostname of the proxy server

      • port: the port at which the server can be reached

      • user (optional): the user name for basic authentication with the proxy

      • password (optional): password for basic authentication with the proxy

    3. Click Save.

    This will automatically ensure that your connection will use the proxy for communication.

  4. Click Connect to Celonis Platform to generate the Verification URL.


    The AppKeys will be stored locally on your machine. We recommend that you additionally encrypt the AppKey in the Encryption Settings.

  5. Copy the Verification URL.

  6. (Optional) Connect to SAP. This step is only required when automating in SAP. For more information, see Connecting to SAP.


  1. Go to the Verification URL.

  2. Log in to Celonis Platform.

  3. Review the request and select the required permissions.

  4. Click Authorize.

Newly created clients will also now be visible in the On-prem clients overview page under Admin & Settings > On-prem clients.

What’s next 

Create a Data Connection to connect to a specific source system and extract data from it into the Celonis Platform. For more information see, Data Connections.

If you want to start creating automations for your on-prem application, create a link between Celonis Platform and your on-prem system. See Creating on-prem connections.