The docker image can be built by running a docker build with the
Dockerfile located in the
Mandatory environment variables:
UPSTREAM_PWAin the form of
For HTTP, the server will run on default port 80.
If HTTPS is chosen as an upstream, it will run on default port 443.
In the latter case the files
server.crt have to be supplied in the container folder
/etx/nginx (either by volume mapping with
docker run or in the image itself by
For deploying to test environments that should not be indexed by search bots or should not be accessible by the public, the nginx container can be set up with basic authentication.
Just supply a single user-password combination as environment variable, i.e.
You can also whitelist IPs by supplying a YAML list to the environment variable
nginx: environment: BASIC_AUTH: 'developer:!InterShop00!' BASIC_AUTH_IP_WHITELIST: | - 172.22.0.1 - 220.127.116.11
Entries of the IP whitelist are added to the nginx config as
allow statements, which also supports IP ranges.
Please refer to the linked nginx documentation on how to configure this.
After activating basic authentication for your setup globally you can also selectively deactivate it per site.
See Multi-Site Configurations for examples on how to do that.
If the nginx container is run without further configuration, the default Angular CLI environment properties are not overridden.
Multiple PWA channels can be set up by supplying a YAML configuration listing all domains the PWA should work for.
For more information on the multi-site syntax, refer to Multi-Site Configurations
The configuration can be supplied simply by setting the environment variable
Alternatively, the source can be supplied by setting
MULTI_CHANNEL_SOURCE in any supported format by gomplate.
If no environment variables for multi-channel configuration are given, the configuration will fall back to the content of
nginx/multi-channel.yaml, which can also be customized.
⚠️Multi-Channel configuration with context paths does not work in conjunction with service workers
An extended list of examples can be found in the Multi-Site Configurations guide.
The page speed configuration can also be overridden:
NPSC_ENABLE_FILTERSto a comma-separated list of active Page Speed Filters to override our carefully chosen defaults. Do this at your own risk.
Built-in features can be enabled and disabled:
CACHE=offdisables caching (default
PAGESPEED=offdisables pagespeed optimizations (default
COMPRESSION=offdisables compression (default
DEVICE_DETECTION=offdisables user-agent detection (default
PROMETHEUS=onenables Prometheus metrics exports on port
New features can be supplied in the folder
A file named
<feature>.conf is included if the environment variable
<feature> is set to
yes (checked case in-sensitive).
The feature is disabled otherwise and an optional file
<feature>-off.conf is included in the configuration.
The feature name must be all word-characters (letters, numbers and underscore).
If the cache feature is switched off, all caching for pre-rendered pages is disabled.
If the cache should also be disabled for static resources, the page speed feature has to be switched off as well as it caches optimized images individually.
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.