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 drei Dinge: einen QR-Code, den du mit der PoolPilot App oder einfach mit der Kamera deines Smartphones scannst, denselben Link als Text – öffne ihn auf dem Handy (antippen oder im Browser des Handys aufrufen), dann öffnet sich die PoolPilot App – und den Fingerabdruck des Relays, den du in der App von Hand eingeben kannst.

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 – je nach Poolsteuerung laufen jetzt Fernzugriff, Push und das Teilen darüber.

Gut zu wissen

  • Konfiguration: Alles Wichtige stellst du in der App ein. Die Datei /etc/poolpilot-relay/config musst du normalerweise nicht anfassen – falls doch, steht alles unter Updates & Einstellungen.
  • Updates: Das Relay aktualisiert sich nachts von selbst. „Jetzt aktualisieren“ und der Schalter für automatische Updates gehören dem Besitzer des Haushalts – andere gekoppelte Handys sehen den Status und können nach einem Update suchen lassen. UPDATE_DISABLED=1 in der Config schaltet Updates ganz ab, dann geht auch „Jetzt aktualisieren“ nicht mehr.
  • Entfernen: Die vollständigen Deinstallations-Befehle stehen unter Hilfe & Befehle.

Relay-Repository & Doku