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}
If there is an error during the installation, you can try uninstalling any existing packages by:
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
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
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}}
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}}
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
Open the Docker Container window in docker.desktop on the Desktop and run the wdx-runtime. See the ouput as a port 8481.
Then navigate the Image Menu on the right to run the wdx-runtime.