logiccloud/logiccloud-control repository overview

⁠Using Docker to run logiccloud Control

⁠What is logiccloud Control?

logiccloud Control manages the logiccloud runtime and services and allows you to turn any edge device into a programmable virtual PLC.

⁠Installation instructions (Linux)

Copy and run this single command on your device. It uses Docker itself to fetch the installer — no curl or wget required on the host — and then sets up the Edge Runtime end to end. The following command pulls an alpine image via Docker to download linux-setup.sh into the current directory, then runs it to install the activation service and the Docker container.

sudo docker run --rm -v "$(pwd):/out" alpine:latest sh -c "wget -O /out/linux-setup.sh 'https://app-eu.logiccloud.io/edge/runtime/install/linux-setup.sh'" && sudo bash linux-setup.sh --runtime docker install

Follow the interactive script to install the container with defaults or to customize the installation.

⁠Management commands

The linux-setup.sh script provides various useful commands to troubleshoot or configure the installation:

⁠Check status

Displays the current status of both the activation service and the container runtime.

sudo ./linux-setup.sh status-activation && sudo ./linux-setup.sh status-container

⁠Update runtime

Updates the container runtime to the latest version without affecting your configuration.

sudo ./linux-setup.sh update-container

⁠Reinstall runtime

Completely reinstalls the container runtime. Use this to fix corrupted installations.

sudo ./linux-setup.sh reinstall-container

⁠Configure

Opens the configuration wizard to modify runtime settings.

sudo ./linux-setup.sh configure

⁠Uninstall

Removes both the container runtime and activation service from your system.

sudo ./linux-setup.sh uninstall-container && sudo ./linux-setup.sh uninstall-activation

⁠Device specific flags

Similar to the runtime connections, some devices will also require specific flags to mount host resources.

⁠Wago CC100 specific

The logiccloud runtime uses a specific connector for the CC100 device which requires access to the following paths:

• /sys/bus/iio/devices/
• /sys/devices/platform/soc/44009000.spi/spi_master/spi0/spi0.0/
• /sys/kernel/dout_drv/

⁠RaspberryPI specific

If you plan to use the RaspberryPI connector to access the GPIO pins, the container must run in privileged mode on the device. This can be done with the interactive script by customizing the installation.

⁠Using ModbusRTU with logiccloud

When using ModbusRTU, the proper serial device must be mapped in the container, so the interactiv script must customize the installation. In the custom device mappings, enter the serial device path (eg. /dev/ttyS0). Get the correct name of the serial device from the device manual and identify the right serial port for the mapping.

⁠Using podman

The logiccloud control fully supports podman installations. In order to use podman, use the following installation command:

sudo podman run --rm --network=host -v "$(pwd):/out:Z" alpine:latest sh -c "wget -O /out/linux-setup.sh 'https://app-eu.logiccloud.io/edge/runtime/install/linux-setup.sh'" && sudo bash linux-setup.sh --runtime podman install