Skip to main content


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

Deploying Pega Platform

Updated on July 8, 2022

Pega provides three different deployment options to best fit your infrastructure needs. Options include a fully-managed deployment with Pega Cloud Services, a client-managed cloud solution, or an on-premises deployment.

  • Pega Cloud Services – Pega manages your cloud service, which is optimized for running Pega applications in a cloud environment. A Pega Cloud Services subscription is the fastest time to value.

    For more information about Pega Cloud Services, see .

  • Client-managed cloud solution – Pega clients are responsible for the orchestration, automation, and operation of their cloud environments on any of the validated infrastructure providers. Pega clients (or partners) manage performance, monitoring, scaling, security, and maintenance such as applying Pega software updates.

    For information about deploying Pega Platform on your personal cloud, see About client-managed cloud.

  • On premises deployment – Pega clients are responsible for the orchestration, automation, and operation of their own database and application server on any of the validated infrastructure providers. Pega clients (or partners) manage performance, monitoring, scaling, security, and maintenance such as applying Pega software updates to their in-house environment.

    Pega supports most popular application servers and database platforms for on-premises deployments. For a comprehensive list of supported platforms, see the Platform Support Guide.

    For information about deploying Pega Platform on premise, see the installation guides for your release at Install Pega Platform.

Deployment behind a reverse proxy

To deploy Pega Platform behind an HTTP proxy server, use XF-* extension headers. Deploying in this manner does not require any additional configuration of Pega Platform.

Refer to the documentation for your proxy server or load balancer for information about how to implement XF-* extension headers.

Note: If you are accessing your Pega Platform system via a Load Balancer or a Reverse Proxy, you must ensure it is correctly configured before implementing single-sign on, such as SAML and OIDC. For more information, see:

The following table describes the XF-* extension header properties.

PropertyRequired?Default valueDescription
X-Forwarded-ProtoRequiredNoneThe original HTTP protocol requested by the client (HTTP or HTTPS).
X-Forwarded-HostOptional from Pega 7.3 and later; required in Pega 7.2.xHost from the standard HTTP headerThe original host requested by the client. Only one value can be specified; a comma-delimited list is not supported. If X-Forwarded-Host is not specified, configure the proxy to preserve the standard host header.
X-Forwarded-PortOptional80 (for HTTP) 443 (for HTTPS)The original port requested by the client.

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us