Anleitung

Relay einrichten – Schnellstart

Für alle, die schon einen Raspberry Pi oder Linux-Rechner mit systemd im Netzwerk haben. In rund drei Minuten steht das Relay.

ca. 3 Min Einsteigerfreundlich Zuletzt aktualisiert:

Voraussetzungen

Noch kein Gerät am Laufen? Dann nimm die ausführliche Anleitung – sie richtet einen Raspberry Pi von Grund auf ein.

Relay installieren

Öffne ein Terminal auf dem Gerät (per SSH oder direkt) und führe den Installationsbefehl aus:

curl -fsSL https://get.poolpilot.eu/install.sh | bash

Der Installer erkennt die Architektur, lädt die passende Version, prüft sie kryptografisch (SHA-256-Prüfsumme, dazu eine minisign-Signatur, sofern das Tool verfügbar ist) und richtet einen systemd-Dienst ein. Kurz bevor er Systemrechte braucht, zeigt er dir die genauen Schritte und fragt dann nach deinem sudo-Passwort.

In der App koppeln

Öffne die PoolPilot App auf einem Gerät, das im selben Netzwerk ist. Die App findet das Relay automatisch – folge einfach den Hinweisen zum Koppeln.

Wird es nicht automatisch gefunden, lass dir den Kopplungscode direkt auf dem Relay anzeigen:

sudo poolpilot-relay show-pairing

Das zeigt einen QR-Code, sowie den Fingerprint des Relays. Der QR Code kann direkt über die PoolPilot App oder einfach mit der Kamera deines Smartphones gescannt werden, um das Relay zu koppeln. Alternativ kannst du den angezeigten Fingerprint auch manuell in der App eingeben.

ProCon.IP-Einstellungen, Abschnitt Fernzugriff: Eintrag „PoolPilot Relay“ mit dem Hinweis „In der Nähe gefunden“.
In den Einstellungen der ProCon.IP: Die App hat das Relay im Netzwerk gefunden.
Bildschirm „PoolPilot Relay“: Karte „PoolPilot Relay gefunden“ mit Button „Relay einrichten“, darunter „Kopplungscode scannen“ und „Fingerabdruck manuell eingeben“.
Ein Tipp auf „Relay einrichten“ – oder per Kopplungscode bzw. Fingerabdruck koppeln.
PoolPilot-App, Bildschirm „PoolPilot Relay“: Statuskarte mit grünem Haken – „Relay verbunden“, „Verbunden“ und „Steuerung erreichbar“.
Gekoppelt und verbunden: „Relay verbunden“ und „Steuerung erreichbar“ mit grünen Haken.

Prüfen, ob alles läuft

Zurück auf dem Relay-Gerät kannst du Status und Logs ansehen:

systemctl status poolpilot-relay
journalctl -u poolpilot-relay -f

Kurz nach dem Start sollte eine Zeile wie agent starting version=… auftauchen. Damit steht das Relay – Fernzugriff und Push laufen jetzt auch für die ProCon.IP.

Gut zu wissen

  • Konfiguration: Alles Wichtige stellst du in der App ein. Die Datei /etc/poolpilot-relay/config musst du normalerweise nicht anfassen.
  • Updates: Das Relay aktualisiert sich nachts von selbst. In der App kannst du „Jetzt aktualisieren“ auslösen oder Auto-Updates abschalten (UPDATE_DISABLED=1 in der Config schaltet sie ganz ab).
  • Entfernen: Die vollständigen Deinstallations-Befehle stehen in der Relay-Doku auf GitHub.

Relay-Repository & Doku