Deploying DPE Admin as docker container

Load Image

Use the file dpe-admin.tar.gzip from the delivery folder to load the image

CODE

docker load < dpe-admin.tar.gzip

Get Image via DAVID Systems Public Docker Registry

Contact support to get an account

https://docker-registry.public.davidsystems.com/dpe-admin:release2025.3.0

Prepare settings.json

Copy the file settings.json from the delivery sub folder webapp to a location where it can be used from docker, e.g. /etc/admin/

Adapt settings.json to connect to your DPE Services, see Prepare settings.json

Create Container

CODE

docker run -p 80:80 --name admin --mount type=bind,source=/etc/admin/settings.json,target=/usr/share/nginx/html/settings.json dpe-admin:latest

Option -p <externalPort>:80 specifies which external port to use, the container internal port is always 80
Option --mount injects/maps the settings.json file from the host location to the inside of container

Docker Compose

Alternatively you can also use a docker compose file

compose.yaml

CODE

version: '3.7'
services:
  dpe_admin:
    container_name: admin
    image: docker-registry.davidsystems.com/dpe-admin:latest
    restart: always
    ports:
      - 80:80
    volumes:
      - /etc/admin/settings.json:/usr/share/nginx/html/settings.json

Environment Variables in a Docker Container

As an alternative to modifying and injecting the settings.json file you can also use environment variables.

The name of the environment variable must start with “ADMIN__” and match the names inside the settings.json file.

Double underscores between names are used to map the hierarchies inside settings.json.

Square brackets are used to reference array elements.

Name postfixes are used to specify variable types different from string, e.g. “:I" for integer or “:B” for boolean.

Examples:

CODE

ADMIN__serviceRootAddress=https://dpe.davidsystems-test.com:5256/DpeWebApplication
ADMIN__appMenu[0]__title=My CM
ADMIN__testFolder__testVariable=bla
ADMIN__testFolder__testInteger:I=123
ADMIN__testFolder__testBoolean:B=true
ADMIN__array[0]=bla
ADMIN__array[1]=bli
ADMIN__array[2]:I=999

HTTPS

The DPE Admin container is supporting HTTP.

Typically, in enterprise environments a HTTPS-offloading proxy is used to route the HTTPS traffic from the outside to an internal docker container.