Skip to main content

On-prem clients system requirements

Here are the system requirements for Automation client and the SAP extraction client.

For system requirements for uplink-based SAP Extractor, see SAP extraction client for PI/PO and SAP 4.6C.

Hardware

Note

The hardware requirements are driven primarily by how much data is extracted simultaneously. There is no way to precisely estimate the data size, and the best approximation is how many tables will be extracted concurrently. The requirements below are for a scenario when 12 large tables (~150 columns) are extracted concurrently.

Automation Agent

SAP Extractor

  • 4GB memory

  • CPU 2 cores

  • 10GB free disk space

  • Virtual machine or physical server

  • CPU: Min. Intel Xeon processor with 4 Cores

  • RAM: min. 16 GB

  • Disk space: min. 110 GB on the tmp directory

  • Location of the server needs to be in the same network as the source system(s) that should be connected

Software

Important

Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice.

Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

  • On-prem clients run on the following 64-bit operating systems:

    • Windows 2022 Server or later

      Windows Server 2012, 2012 R2, 2016, and 2019 are expected to function based on architectural compatibility; however, these versions have not been officially validated in our latest testing cycle and are not formally supported.

    • Linux

      • Distributions: Ubuntu 20.04 or later.

        Other major 64-bit distributions (including but not limited to RHEL 9+, CentOS 9+, and Debian 10+) are expected to function correctly but have not been formally tested and are not formally supported.

      • Interface: Fully supports both CLI and GUI environments.

  • Runtime dependencies:

    Note

    Most servers have these dependencies installed by default and don't require manual installation.

    • Windows: Microsoft Edge WebView2

      Microsoft Edge WebView2 is automatically downloaded and installed as part of the on-prem clients installation. However, if you're using a server that doesn't allow for automatic downloads, you must manually download and install Microsoft Edge WebView2.

    • Linux: libgtk-3 and libwebkit

      Note: This dependency is only required if UI is needed. There are no extra dependencies for the CLI tool.

    • MacOS: Xcode command line tools

    • GUI-less servers (using CLI tool): No dependencies

  • Java 21 or later; OpenJDK is also supported, and we recommend AdoptiumOpenJDK

    Upcoming Java 25 Requirement for OPCs and OPEs

    Starting April 2026, upgrading to the latest On-Premise Client (OPC) or On-Premise Extractor (OPE) will require Java 25. Current installations will remain unaffected (non-breaking change) unless you choose to update to the newest OPC or OPE versions. We will provide finalized Java requirements once the release versions are confirmed.

    While no immediate action is required, we recommend planning your Java environment updates now to ensure a smooth transition.

  • For Windows, install the following redistributable package available from Microsoft Download Center:

    • Microsoft Visual C++ 2013 Redistributable Package (x64)

  • SAP Java Connector (SAP JCo) 3.1 or later - this library is necessary for establishing a connection between Celonis Platform and your SAP instance. For detailed instructions on how to use this library, see 4. (optional) Connecting to SAP.

  • RFC module - this module is necessary for extracting data from the SAP database based on information received from the SAP extraction client. See Installing the RFC module.

    Note

    The on-prem client is compatible with RFC module version 3.6.0 or later.

Network connectivity and access for SAP Extractor

Connections for operations of SAP Extractor

Table 1. Connections for operations of the SAP Extractor

Source system

Target system

Port

Protocol

Description

On-premise extractor server

SAP ECC system

33XX (where xx is the system number)

TCP

RFC connection from on-premise extractor server to the SAP system. The system number can be retrieved from the SAP basis team.

On-premise extractor server

Celonis cloud endpoint

443

TCP

HTTPS connection from on-premise extractor server to Celonis cloud endpoint. The IPs of the endpoint depend on the cloud realm (which can be seen in the URL) and they can be found the section below.



Cloud IP addresses depending on the realm

The IP of the realm where the Celonis Platform team resides should be allowlisted so that the on-premise extractor can communicate with the Celonis Platform cloud endpoints.

Using proxies (optional)

Please refer to Proxy settings for on-premise clients.

Ensuring certificate trust for OPC agents

If your environment uses SSL interception as part of a firewall, you may encounter connection issues because OPC agents cannot validate the Celonis server certificates. This typically occurs when the firewall intercepts the SSL connection, establishes a new one with the client, and then presents a custom certificate, often self-signed or signed by an internal Certificate Authority (CA). These Man-in-the-Middle (MITM) certificates are not trusted by the OPC agent by default, leading to failed certificate validation.

To fix this issue, you can import your MITM certificates into the Java keystore used by the OPC agent. This allows the agent to trust the intercepted SSL connection and successfully validate the Celonis server certificates. For more information on adding your certificates to the OPC agent keystore, see "unable to find valid certification path" errors.

Related topics