Setting up Celonis on-prem Agent for Skills
This guide provides step-by-step instructions how to manually set up the Celonis On-Prem Agent for Skills.
Install the Celonis Agent
Step 1: Set up Server for the Celonis Agent
(responsible role: server/ infrastructure administrator)
Information on the hardware and software requirements of the server for Celonis Agent can be found here: Preparing Server for Celonis Agent
Step 2: Download & unpack Celonis Agent package
(responsible role: server/ infrastructure administrator)
The Celonis Agent package is available for download here: Downloading Celonis Agent Package
Step 3: Create Application Key and grant permission "Register Agents"
(responsible role: Celonis administrator)
Information on creating the Application Key and granting the correct permission can be found here: Creating Application Key for Celonis Agent
Step 4: Configure Application.yml file
(responsible role: Server/ infrastructure administrator)
Information on configuring the application.yml file for Celonis Agent can be found here: Adjusting Application.yml for Celonis Agent
Step 5 (optional): Connect to SAP ECC
(responsible role: SAP basis & server/ infrastructure administrator)
Information on connecting to SAP ECC can be found here: Connect to SAP.
Note
This step is only required when automating in SAP.
Step 6: Start Celonis Agent
(responsible role: Server and infrastructure administrator)
Information on starting Celonis Agent can be found here: Starting Celonis Agent
Step 7: Add System Connections
(responsible role: Celonis analyst)
Information on adding system connections can be found here: Add System Connections
Update to a New Version
Download the newest version of the Agent and go through the manual step-by-step guide (see above).
When updating from below v0.4.4 to v0.4.4 or higher
If starting the agent as a Windows service: Make sure the SAP NW RFC SDK is added to the Path system environmental variable
As described on the page Connecting to SAP, for an agent running as a windows service, the sap-lib/lib folder needs to be added to the Path system environmental variable (as selected in the middle screenshot).
![]() |
![]() |
This will register a new Agent in your team.
Note
Don't forget to stop your old Agent (e.g. if you are using task scheduler) after you have moved everything to the new version.
(Re-)Configure the Agent
After installing the Agent, you can (re-)configure the Agent for specific setups instead of rerunning the complete installation for small changes. The workflow can be found here in order to rename the agent or set limit for concurrent executions.