To simply build the Intershop PWA in server-side rendering mode, you can use the package.json script
npm run build, which builds the Intershop PWA with the
production configuration of the
Afterwards you can start the application with
npm run serve (or do both by using
npm run start).
The preferred way for production deployments is to build the
Dockerfile in the project root and run the created image.
While building, you can provide a build argument (i.e. via
configuration and build a different configuration from angular.json.
By default the
production configuration is built.
configuration options can also be multiple configurations like
--configuration=brand,production, where production should always come last.
Overwriting configurations of the PWA is entirely done by environment variables.
This approach was chosen to have the best possible compatibility when running the PWA either from the command line or in an orchestrator.
To set environment variables in windows run for example
set SSR_HYBRID=true on the command line before executing the
npm run commands.
If the format is any, then the environment variable has to be set to any value to be active.
Setting it to
"false" still counts as active.
Only empty strings count as inactive.
If the format is switch, the property is switched on by supplying
true (checked case-insensitive), anything else is considered
All parameters are case sensitive.
Make sure to use them as written in the table below.
|SSR Specific||PORT||number||Port for running the application|
|General||ICM_BASE_URL||string||Sets the base URL for the ICM|
|ICM_CHANNEL||string||Overrides the default channel|
|ICM_APPLICATION||string||Overrides the default application|
|FEATURES||comma-separated list||Overrides active features|
|THEME||string||Overrides the default theme|
||TRUST_ICM||any||Use this if ICM is deployed with an insecure certificate|
|LOGGING||switch||Enables extra log output|
|Hybrid Approach||SSR_HYBRID||any||Enables running PWA and ICM in Hybrid Mode|
|PROXY_ICM||any | URL||Proxy ICM via
|Third party||GTM_TOKEN||string||Token for Google Tag Manager|
|SENTRY_DSN||string||Sentry DSN URL for using Sentry Error Monitor|
|PROMETHEUS||switch||Exposes Prometheus metrics|
|ICM_IDENTITY_PROVIDER||string||ID of Identity Provider for SSO|
|IDENTITY_PROVIDERS||JSON||Configuration of Identity Providers for SSO|
We deliver a selfsigned x509 certifciate for local development/deployment purposes only.
For obvious reasons (e.g we do not know your hostname) we cannot deliver a certificate that is accepted by web browsers.
Therefore be prepared for security questions when first accessing the site.
Our image build process is expecting files
server.key in folder
crt is the certifcate and
key represents the private key.
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.