How to setup and manage gateways

This section describes how to add various Gateways via the SDA Console.

Types of gateways

There are 2 types of gateways supported via the SDA Console:

  1. Gateway as a native Linux installation (Debian-based)

  2. Gateway as a Docker container

  3. Gateways for virtual PLCs (please contact SDA to get access to this feature)

Setting up a gateway

Below you will find the instructions for setting up physical gateways (types 1 and 2 above) and a reference for setting up virtual gateways in the context of Virtual PLC (type 3 above).



SSH client

Tool to run SSH commands on your local machine (e.g., OpenSSH or PuTTY)

Network connectivity

Your local machine requires access to the network with the gateway of your choice

IP address

IP address of the gateway you wish

to connect

Username and password

Credentials of the gateway you wish

to connect

You have multiple options with respect to the SSH client.

Most people use the preinstalled OpenSSH on Linux to run SSH commands directly from the shell.

Note that some people also use PuTTY for debugging, connecting to serial ports, and to raw sockets. To set up PuTTY on Debian, use the following command:

sudo aptitude install putty

Followed by the tools installation command:

sudo aptitude install putty-tools

Setting up a gateway as a native Linux installation

In order to set up a gateway, navigate to the Gateways pane and click "+".

Under "Add New Device" choose "Gateway".

Choose a name for the Gateway and click "Save".

To set up a hardware gateway, please choose the tab "Ubuntu". Automatically copy the command to your clipboard by clicking on the "command window".

Please note that the command is only valid for 60 minutes.

Please navigate to your Linux shell, macOS terminal, or Windows PowerShell.

Connect to the device that you intend to use as your gateway and establish a Secure Shell (SSH) session by running the following command:

ssh <user>@<IP-Address>

For the username root and the IP address, the command would look like this:

ssh root@

After hitting enter, you may be asked to enter your gateway's password.

Now you are ready to paste the command copied from the SDA Console. This will initiate the set-up of the SDA Connectivity Client on your gateway.

Setting up a gateway as a Docker container

To set up your local machine or IPCs as an edge gateway, please start by installing Docker to your machine here:

Next, start Docker Desktop, open your shell, terminal, or PowerShell, and paste the command copied from your SDA Console unter "Setup Gateway" / "Docker" as seen in the figure below.

The installation process will look similar to the screenshot below.

Check if gateway installation was successful

After the installation, go back to the SDA Console and reload the entire page via the respective web browser function. Afterwards, when clicking on the newly created gateway the status "Gateway Health" should return a green checkmark. If the status is negative, (a) your firewall blocks the connection or (b) the installation was not completed successfully. Please contact SDA to get support.

Modifying a gateway

In order to modify a gateway configuration in the SDA Console, please right-click the respective gateway and click "Edit" to modify the name of the gateway. Click "Save" to save your changes.

In order to access the setup of your gateway later on, please right-click the respective gateway, click "Setup", re-run the SSH/Docker commands as described in the sections above.

Deleting a gateway

In order to delete a gateway, navigate to the respective gateway, perform a right click, and click "Delete".

Please note: You will not be allowed to delete a gateway that still has child controls. Please delete those controls first before deleting the gateway.

Last updated