Install WDX

Prerequisites

Download WDX on the Download Page. Depending on which device you want to run WDX, you need to choose the relevant file.

1. Installation on a PLC

Before installing .ipk

For this example we're using a Wago CC100, for other Devices the requirements might differ slightly.
In order to be able to install WDX on your device, you'll need to set it up first:

Setting Up CC100

You'll need to connect your CC100 with an USB-C cable to your computer and in a browser open: http://192.168.42.42 to access the Wago Web-Based-Management (WBM).

For the initial login use: Username: admin
Password: wago

The credentials can and should be changed after the first login was successful.
Choose either a static IP under the Networking Tab or a connection via DHCP to be able to properly use the CC100 without the USB-C cable and instead use an ethernet connection.

Preparing µSD Card

It is generally discouraged to install packages directly on your PLC, as it only has limited space.
Instead the CC100 comes equipped with a µSD Card Slot to install applications.
Insert the SD card into the CC100 and in the WBM navigate to Mass Storage and choose Ext4 as the format.

Upload Firmware

Before you you install WDX, make sure your device runs on the latest Firmware. To update your Firmware on a CC100 you can download the latest Firmware. and use WAGO Upload to apply the Firmware on your device.

Install .ipk with SSH Connection

Alternatively, the .ipk can be uploaded to your PLC with a software like Filezilla and then using a SSH connection with a tool like Putty you can enter this command to install the .ipk manually:

opkg install {full_filename}
opkg install {full_filename}

If there is an error during the installation, you can try uninstalling any existing packages by:

opkg remove {package_name}
opkg remove {package_name}

2. Installation via Docker

Install Docker

Download Docker Desktop Installer.exe from this source:
https://docs.docker.com/desktop/install/windows-install/
Install Docker and restart your Computer.

Launch Docker Desktop

Open Docker Desktop:
After installation, you can find Docker Desktop in your Start Menu. Click on Docker Desktop to launch the application.

Sign in or create a Docker account (optional):
You will be prompted to sign in to Docker Hub if you have an account. You can skip this step if you don’t have an account, or create one for access to Docker images.

Allow Docker to start:
Docker will initialize, and it may take a minute for Docker to start. Once it starts, the Docker icon will appear in the system tray.

Verify Docker is running:
Once Docker has started, you can verify it's running by opening PowerShell or Command Prompt and typing:

docker --version
docker --version

Download Docker Image

Download the eDesign/WDX-Docker-image from here: eDesign Downloads
Open your Command Prompt and move to the directory, where the eDESIGN-Docker-image is located, for example.:
C:\Users\YOUR-USER-NAME\Downloads

Run Docker Image

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

docker load -i wdx-runtime-x86_64-x.x.x.x.tar
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:\workspace\wdx_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}}
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}}
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}}

How to use Node/RED under Windows11 Docker

docker load --input node-red-wdx-3.2.0.2.tar

C:\Users\YOUR-USER-NAME\Downloads>docker load --input node-red-wdx-3.2.0.2.tar

Loaded image: node-red-wdx:3.2.0.2-X86_64-alpine

Type this Loaded Image into the command prompt:

docker run -d --name wago-node-red -d --privileged=true --user=root -p 1880:1880 -v node-red-wdx:/data node-red-wdx:3.2.0.2-X86_64-alpine
docker run -d --name wago-node-red -d --privileged=true --user=root -p 1880:1880 -v node-red-wdx:/data node-red-wdx:3.2.0.2-X86_64-alpine

Open the Docker Container window in docker.desktop on the Desktop and run the wdx-runtime. See the ouput as a port http://localhost:8081/.

Then navigate the Image Menu on the right to run the wdx-runtime.