Setup Guide

Linux

Docker

Weidmüller

u-OS

Hilscher

OI4

ctrlX

Bosch Rexroth

Docker Setup Guide

1. Sign up for SwarmGuard

Please sign up for a SwarmGuard account.
Download the SwarmGuard Industrial mobile application from either the Google Play Store or the Apple App Store by scanning the QR code below.
Open the app and sign in with your account (email address and authentication code).

2. Install Docker (if it isn’t already installed)
Prepare a first device for your swarm network by installing the Docker engine . Follow these instructions for the supported platforms:

- Raspberry Pi OS
- Ubuntu
- Debian
- CentOs
- Fedora
- RHEL
- SLES
- Other OS

3. Install SwarmGuard Agent
You can either install a regular agent or alternatively an agent + ingress gateway (see more infos below).

Regular Agent
Run the following command to install a regular agent on your device:

curl -fsSL https://swarmguard.io/install-as-docker-compose.sh | sh content_copy
Agent + ingress gateway
Run the following command to install an agent with an ingress gateway on your device:

curl -fsSL https://swarmguard.io/install-gateway-as-docker-compose.sh | sh content_copy

4. Add your device to the swarm

Start SwarmGuard on your device by running swarm up.
Use the SwarmGuard Industrial mobile application and scan the QR code issued by the swarm up command on the device.

5. Add more devices to your swarm network
Repeat steps 2 to 4 for additional devices.

Good To Know

SwarmGuard autonomously creates a full-mesh overlay network encompassing all the registered devices, known as the swarm. Access devices within the swarm using the domain name <device-name.swarm>.

Ingress Gateway

An ingress gateway functions as a bridge between the public internet and your private swarm network. If you configure one or more of your swarm devices as ingress gateways (with a public internet connection and a public IP address), you can forward designated ports to other devices within your private swarm network.