Skip to main content


Installing Constellation by using Helm for Kubernetes

Suggest edit Updated on July 21, 2021

Test the latest run-time improvements by installing the Constellation engine, which offers improved performance, responsiveness, and a more convenient authoring experience for portals and views. Kubernetes users can deploy the Constellation update by using a Helm chart.

By using Helm for Kubernetes, you can set up Constellation as a multitenant service for your system.

Note: You do not have to install Constellation manually if your environment meets any of the following criteria:
  • Pega Platform is hosted on Pega Cloud Services.
  • Pega Platform is hosted on a client-managed cloud environment.
  • Cosmos React UI was installed with Pega Infinity.
In these cases, the Constellation engine is already a part of your development environment, and you only need to enable the framework for your applications.
Before you begin: Check your installation environment:
  • Contact Pega to gain access to the customer repository. Constellation files are in the Pega Infinity folder.
  • Ensure that you have a working Kubernetes cluster.
  • Ensure that you have Helm and Kubectl command line interface installed on your on-premises environment.
  • Ensure that you can communicate with the Kubernetes cluster by using Kubectl.
  • Review the process of implementing Constellation on your system. For more information, see Implementing Cosmos React UI in Pega Platform.
  1. In the Kubectl terminal window, create a namespace to which you want to deploy the service by entering kubectl create namespace <name of the namespace>.

    For example: kubectl create namespace Reactui.
  2. Create a secret with dockerconfig in the namespace by entering kubectl create secret generic regard --from-file=.dockerconfigjson=<path to dockerconfig.json> -n <name of the namespace>.

    Result: The system downloads the Constellation image to the cluster.
  3. Create a TLS secret with a certificate and a key by entering kubectl create secret tls ingresssecret --key <path to the key> --cert <path to the certificate> -n <name of the namespace>.

  4. Install NGINX Ingress Controller for Kubernetes.

    For more information, go to the NGINX website.
  5. In the terminal window, install Constellation by entering helm install <path to the ReactUI helm charts> --values <path to values.yaml> —namespace <name of the namespace> --generate-name.

    Result: The service is now available at https://<host name used in ingress>:<port exposed by nginx>/c11n.
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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