Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring Pega Robotic Automation

Updated on October 19, 2022

Use the Pega RPA configuration files to set options for Robot Runtime, Credentials Manager, and Robot Studio.

In the header of Pega RPA, click ToolsShortcutsFiles to open the menu of configuration files.

Configuration files on the Tools menu
Menu of configuration files accessed from the Shortcuts option of the Tools menu.

The following table describes the main configuration files for Pega RPA:

File nameDescription
CommonConfig.xmlThis file contains information necessary to connect to and work with Robot Manager, Pega Workforce Intelligence, and other applications.

This file applies to Robot Studio. All settings in this file can be altered by end users. Affected functionality includes diagnostics, deployment options, and log categories. The PegaStudioConfig.json file is initially placed in the installation folder.

When you run Robot Studio for the first time, a copy of the file modified with the your settings is written to your \Appdata\Roaming folder. The following path is an example:


PegaRuntimeConfig.xmlThis file applies to Robot Runtime. Robot Runtime is used when you start a project (with or without debugging) in Robot Studio. It is also used when Robot Runtime runs deployed Robot Studio projects. Functionality defined in the PegaRuntimeConfig.xml settings includes diagnostics, deployment options, and log categories.

After a production robot initially connects to Robot Manager, Robot Manager then maintains this configuration file and delivers it to Robot Runtime at startup.

CredentialManagerConfig.xmlThe CredentialManagerConfig.xml file provides configuration information to the internal Credential service. The Credential service provides credentials to the Pega RPA Service, the ASO Manager, and the Credential Store. You specify the provider that you use in the CredentialManager server element in the CommonConfig.xml file.

The Pega RPA configuration files are self-documenting. The comments added to the configuration options explain what you should enter in each section of the configuration file. If you want to review the configuration options before you install the software, download the default configuration files from the following link:

Pega RPA default configuration files

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us