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 eDesign HMI + WDX Runtime
Open your Command Prompt and move to the directory, where the eDESIGN-Docker-image is located, for example.: C:UsersYOUR-USER-NAMEDownloads

macOS:
Download eDesign HMI + WDX Runtime

Step 3: Run Docker Image

WSL:

To load the Docker-image into a Docker-Container in:

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

Then start the Docker-Container. Be aware of the volumes that are going to be mounted. Navigate (i.e. cd c:workspacewdx_docker) to directory where you want to mount the persistant directories.

Windows

docker run -d -p 8081:80 -p 8481:443 --name wdx-runtime -v data:/opt/elrest/edesign/wdx/data -v config:/opt/elrest/edesign/wdx/config -v logs_wdx:/opt/elrest/edesign/wdx/logs -v logs_lighthttp:/var/log/lighttpd/ {{name_of_loaded_image}}

Linux

docker run -d -p 8081:80 -p 8481:443 --name wdx-runtime -v ./data:/opt/elrest/edesign/wdx/data -v ./config/wdx:/opt/elrest/edesign/wdx/config -v ./logs/wdx:/opt/elrest/edesign/wdx/logs -v ./logs/lighthttp:/var/log/lighttpd/ {{name_of_loaded_image}}

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-runtime 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-runtime 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