Zum Inhalt

Linux / Raspberry Pi

This guide describes how to install a Confire Cloud Agent on a Raspberry Pi or a 64-bit ARM-based Linux system.

Please install one agent per network you want to manage.

Prerequisites

  • Before starting the installation, ensure your system meets the minimum requirements:
Component Requirement
Processor ARM Cortex-A53 or better (ARMv8-A 64-bit)
RAM at least 1 GB (2 GB or more recommended)
Storage at least 10 GB free (20 GB recommended)
Display Output Optional – only required if using desktop UI
Network Ethernet or Wi-Fi (for online functions/updates)

The agent runs reliably on:

  • Raspberry Pi 4 (Model B or newer) – with 64-bit OS
  • Raspberry Pi 5 – with 64-bit OS
  • Virtualized or emulated 64-bit ARM Linux environments (e.g., QEMU, Docker ARM64 containers)

Installation

Create Agent in Confire Cloud

  1. Click Agents/Networks in the left menu:

  1. Click the three dots at the top right and select + Add:

  1. Enter a name for the agent and select a Tenant:

  1. Note the Agent ID and click **OK**.

Download and Install Agent Software

  • Download the agent software:
curl -O https://download.stueber.de/doc/de/confirecloud/agent/confirecloudagent.tgz
  • Create program directory:
sudo mkdir -p /opt/ConfireCloud/Agent/
  • Extract the archive:
sudo tar -xzf confirecloudagent.tgz -C /opt/ConfireCloud/Agent/
  • Download appsettings.Production.json:
sudo curl -o /opt/ConfireCloud/Agent/appsettings.Production.json https://download.stueber.de/doc/de/confirecloud/agent/appsettings.Production.json

Edit Production File

  • Open appsettings.Production.json in a text editor:
sudo nano /opt/ConfireCloud/Agent/appsettings.Production.json

  • Specify the IP range or broadcast address for ScanIpAddresses that the agent should scan. Example broadcast address: "192.168.1.255" (It also accepts individual IPs or CIDR ranges, e.g., "192.168.1.0/24")

  • Enter the RabbitMQ access data from the email (Host, VirtualHost, Username, Password):

  • Insert the noted AgentId:

  • Save and close the file.

Register ConfireCloudAgent as a Service

  • Copy the service file:
sudo cp /opt/ConfireCloud/Agent/ConfireCloudAgent.service /etc/systemd/system
  • Enable the service (start at boot):
sudo systemctl enable ConfireCloudAgent
  • Start the service:
sudo systemctl start ConfireCloudAgent
  • Check the status:
sudo systemctl status ConfireCloudAgent

Configuration

Manual Device Specification

Instead of using automatic broadcast detection, you can specify the devices to manage directly by IP address. This is especially useful when:

  • Broadcast detection is restricted on the network

  • Devices are located in different subnets

In the example below, five devices were detected via broadcast:

Instead of using broadcast detection, we now want to detect only two specific devices, DIRECT-Room-001 and DIRECT-Room-002. For this, manually enter the devices in the appsettings.Production.json file:

  • Under ScanIpAddresses delete the entry "192.168.1.255":

  • Enter the IP addresses of the desired devices. Make sure the last line does not have a comma:

  • Save the appsettings.Production.json ** file and restart the ConfireCloudAgent ** service:
sudo systemctl restart ConfireCloudAgent
  • Now only the two specified devices will be detected:

Upgrade

To use all new features, always use the latest version of the agent.

  • Stop the service:
sudo systemctl stop ConfireCloudAgent
  • Delete old files except the Production File (optional but recommended):
sudo find /opt/ConfireCloud/Agent/ -mindepth 1 ! -name 'appsettings.Production.json' -exec rm -rf {} +
  • Download the latest version:
curl -O https://download.stueber.de/doc/de/confirecloud/agent/confirecloudagent.tgz
  • Extract:
sudo tar -xzf confirecloudagent.tgz -C /opt/ConfireCloud/Agent/
  • Start the service:
sudo systemctl start ConfireCloudAgent
  • Check the status:
sudo systemctl status ConfireCloudAgent