Installation Docker

Prerequisites

Windows Subsystem for Linux (WSL)

First make sure to have installed Windows Subsystem for Linux (WSL) on your Computer.
Search for Command Prompt (or PowerShell), right-click the top result, and select the Run as administrator option.
Type in:

wsl --list --verbose

When no Linux installation is listed, you have to install Linux Subsystem.
Type in your Command Prompt (or PowerShell):

wsl --install --web-download

Check afterwards again if Linux is installed.

macOS

There is no need for WSL on mac OS. Docker can be installed directly.
Make sure you are using:

• Mac with macOS 11.0 (Big Sur) or later
• Either an Intel or Apple Silicon (M1/M2/M3/M4) chip

Check if Docker is already installed:
Open Terminal (Applicatios > Utilities > Terminal) and type:

docker --version

If the command is not recognized, proceed with the installation.

Step 1: Install Docker

Windows:
Download Docker Desktop Installer.exe from this source:
https://docs.docker.com/desktop/install/windows-install/

• Install Docker and restart your Computer.

macOS:
Download Docker.dmgfrom this source:
Docker macOS Download

1. Open the downloaded .dmg file
2. Drag the Docker icon into your Applications folder
3. Launch Docker firm Applications

Step 2: Download Docker Image

Windows:
Download Windows Docker Image x86_64
Open your Command Prompt and move to the directory, where the eDESIGN-Docker-image is located, for example.: C:UsersYOUR-USER-NAMEDownloads

macOS:
Download macOS Docker Image x86_64

Important: Clear Existing Docker Containers First

Before loading the WDX Docker image, make sure your Docker is clean — otherwise, conflicts may occur with existing containers.

There are two ways to do this:

• Option 1: Via Docker Desktop (GUI)
  Open the Docker Desktop application and manually stop and remove any running containers using the graphical interface.

• Option 2: Via Terminal / PowerShell
  You can remove the container directly using the following command:

docker stop wdx-runtime
docker rm wdx-runtime

Step 3: Run Docker Image

WSL:

To run the Docker container, you must first import the .tar image file into Docker.

1. Load the Docker Image

In your Command Prompt or PowerShell, run:

docker load -i wdx-runtime-x.x.x.x.tar

• Replace x.x.x.x with the actual version of your image file (e.g. 4.0.1.83)

• ⏳ Note: After typing the docker load -i ... command, the terminal may appear inactive for several seconds — this is normal.
  The loading process takes a bit of time and gives no immediate feedback.
  Once complete, you will see a message like:

Loaded image: wdx-runtime:4.0.1.83-X86_64-alpine

You can check the correct image name using docker images after loading.

2. Navigate to your working directory

Now decide where your persistent data should be stored on your machine. This is important, because we’ll mount these folders into the Docker container to make sure that your configuration, runtime data and logs are not lost when Docker is restarted.

We recommend creating a working folder like this:

mkdir C:\workspace\docker
cd C:\workspace\docker

If you're not familiar with this:

• mkdir means “make directory” — this creates a new folder called docker inside C:workspace

• cd means “change directory” — this opens the folder so that your commands run from the right place

3. Run the Docker Container

Windows

docker run -d -p 8081:80 -p 8481:443 --name wdx-runtime --restart unless-stopped -v C:\workspace\docker\data:/opt/elrest/edesign/wdx/data -v C:\workspace\docker\config:/opt/elrest/edesign/wdx/config -v C:\workspace\docker\js-storage:/opt/elrest/edesign/wdx/storage wdx-runtime:<version>-X86_64-alpine

• Replace < version > with the version you see in the docker load output.

Linux

docker run -d -p 8081:80 -p 8481:443 --name wdx-runtime --restart unless-stopped -v ~/wdx/data:/opt/elrest/edesign/wdx/data -v ~/wdx/config:/opt/elrest/edesign/wdx/config -v ~/wdx/js-storage:/opt/elrest/edesign/wdx/storage wdx-runtime:<version>-X86_64-alpine

• Replace < version > with the version you see in the docker load output.

→ If everything works, you'll see a container ID like:

e16bdca52fd05497bea5235d77c9bf1231503bc63d8cfcb30ba8dea6ffd035c0

macOS:

This guide explains how to load and run the wdx-runtime Docker image on macOS. Please ensure that Docker is installed and running before proceeding.

1. Is the file really in the Downloads folder?
   In your Terminal, type:

ls ~/Downloads

2. Check if there's a file named something like (e.g. wdx-runtime_3.2.1.127_x86_64.tar)

3. To load the Docker image into a Docker container, open your Terminal and type:

cd ~/Downloads
docker load -i wdx-runtime_x.x.x.x_x86_64.tar

Dont forget to replace (x.x.x.x) with the actual name in your folder.

4. Confirm with:

   docker images

   look for something like: wdx-runtime 3.2.1.127-X86_64-alpine

5. Run the Container

   docker run -d --platform linux/amd64 -p 8081:80 -p 8481:443 --name wdx-runtime2 wdx-runtime:X.X.X.X-X86_64-alpine

Dont forget to replace (x.x.x.x) with the actual name in your folder.

Sometimes it doesn't work after you restarted Docker

Then simply type in your terminal/ consol

docker stop wdx-runtime
docker rm wdx-runtime

and then restart:

docker run -d --platform linux/amd64 -p 8081:80 -p 8481:443 --name wdx-runtime2 wdx-runtime:X.X.X.X-X86_64-alpine

Dont forget to replace (x.x.x.x) with the actual name in your folder.

Open eDesign in Your Browser

http://localhost:8081/
https://localhost:8481/

Useful links

Install Docker Desktop on Windows: https://docs.docker.com/desktop/install/windows-install/

Install Docker Desktop on macOS:
macOS install help

More information on how to install Linux on Windows with WSL
https://learn.microsoft.com/en-us/windows/wsl/install

Manual installation steps for older versions of WSL
https://learn.microsoft.com/en-us/windows/wsl/install-manual