Applicable to Cosmos React and Theme Cosmos applications Before you begin: Prepare for the installation:
Explore the latest React-based run-time environment, which improves performance
and responsiveness, and offers a revised set of user-friendly tools for authoring views
and portals. You can use Docker to install the Constellation engine framework in your
on-premises development environment.Note: You do not have to install Constellation manually if your environment meets any of the
In such cases, the Constellation engine is already a part of your development
environment, and you only need to enable the framework for your applications.
- Pega Platform is hosted on Pega Cloud services.
- Pega Platform is hosted on a client-managed cloud
- Constellation was installed with Pega Infinity.
- If you are an internal Pega user.
For example: For multiple containers, you can use a Docker compose file similar to the following example:
- Log in to Pega's Docker repository.For example:
docker login pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest
- In a terminal window, pull the Constellation container by entering
- Start the service by entering docker run -v /<path to
folder with key certificate>:/host_folder -p 3443:3443 --name
httpsKey=<SSL key> httpsCert=<SSL
certificate> urlPath=<service URL path>
The variables have the following values:<path to folder with key certificate> is the
absolute path to the local folder that contains the HTTPS key file and
the certificate file.<container name> is the name of the Docker
container.<SSL key> is the name of the key file.<SSL certificate> is the name of the certificate
file.<service URL path> is the URL path on which the
service is deployed. The path must match the load balancer or router
traffic routing.For example: docker run -p 3443:3443 -v /usr/abc/certs:/host_folder --name
port=3443 urlPath=/c11n httpsKey=afile.key httpsCert=bfile.cert
Note: When you deploy behind a load balancer, the load balancer usually holds
the SSL certificate. In this case, you do not need to add the certificate at
# sample compose file to show use of Constellation Static Service
# host_folder needs to be mapped to the host folder containing the ssl cert and key files
# docker-compose -f docker-compose.yml up / docker-compose -f docker-compose.yml down -v
command: httpsKey=tomcat.key httpsCert=tomcat.cer info