Relay-Doku

Hilfe & Befehle

Die meisten Probleme haben einen von drei Gründen – das Relay läuft nicht, Handy und Relay sind nicht im selben Netz, oder die App kennt noch eine alte Identität des Relays. So findest du heraus, welcher es ist, und hier stehen alle Befehle, die du dafür brauchst.

Zuletzt aktualisiert:

Die Befehle auf dieser Seite tippst du auf dem Gerät ein, auf dem das Relay läuft – direkt oder per SSH. Läuft dein Relay in Home Assistant, steht das Passende auf der Home-Assistant-Seite.

Die App erreicht das Relay nicht

  1. Läuft es? systemctl status poolpilot-relay sollte active (running) zeigen. Falls nicht, starte es mit sudo systemctl restart poolpilot-relay neu und schau in die Logs (unten).
  2. Selbes Netz? Zu Hause findet die App das Relay über dein lokales Netz. Dein Handy muss im selben WLAN sein – nicht im Gäste-WLAN und nicht im Mobilfunknetz.
  3. „Nicht erreichbar“ nach einem Werksreset? Ein Werksreset gibt dem Relay eine neue Identität, die nicht mehr zu dem passt, was sich die App gemerkt hat. Dann wirkt es unerreichbar, obwohl alles läuft. Entferne das Relay in der App und kopple es neu (siehe Koppeln & Haushalt).

Ist der Fernzugriff pausiert, obwohl das Relay läuft? Dann schau unter Wenn Pro ausläuft und dem Abschnitt darunter.

In die Logs schauen

systemctl status poolpilot-relay        # läuft es? seit wann?
journalctl -u poolpilot-relay -f        # Live-Logs, beenden mit Strg+C
journalctl -u poolpilot-relay -b        # alles seit dem letzten Hochfahren
journalctl -u poolpilot-relay-updater   # was der Update-Helfer gemacht hat

Der Installer sorgt dafür, dass diese Logs auch Neustarts überstehen. Kurz nach dem Start sollte eine Zeile wie agent starting version=… auftauchen.

Wiederkehrende mDNS-Logzeilen

Siehst du bei jedem Start Zeilen mit Recursion Available bit MUST be zero und (RFC6762 18.7)? Das ist normal und harmlos. Sie stammen aus der Bibliothek, mit der sich das Relay im Netz ankündigt; das gesendete Paket ist korrekt, und das Finden klappt. Neuere Relays blenden die Zeilen aus. Zum Fehlersuchen holst du sie mit MDNS_VERBOSE_LOGS=1 in der Konfigurationsdatei zurück – in Home Assistant mit dem Schalter Zusätzliche mDNS-Logs.

Alle Befehle im Überblick

Im Alltag brauchst du keinen davon – systemd hält das Relay am Laufen, und alles andere machst du in der App.

Befehl Was er macht
sudo poolpilot-relay show-pairing Zeigt den Kopplungscode: QR-Code, Link als Text und Fingerabdruck. Ändert nichts.
sudo poolpilot-relay show-recovery Zeigt einen einmaligen Wiederherstellungscode, um die Besitzer-Rolle zurückzuholen. Gilt wenige Minuten.
poolpilot-relay version Zeigt die installierte Version (auch --version, -v).
poolpilot-relay help Listet Befehle und Optionen (auch --help, -h).
systemctl status poolpilot-relay Läuft das Relay, und seit wann?
sudo systemctl restart poolpilot-relay Startet das Relay neu, z.B. nach einer Änderung an der Konfiguration.
sudo systemctl stop poolpilot-relay Stoppt das Relay.
sudo systemctl disable --now poolpilot-relay Stoppt das Relay und startet es auch beim Booten nicht mehr.

Welche Version gerade läuft, zeigt dir auch die PoolPilot App – oder die Startzeile im Log:

journalctl -u poolpilot-relay | grep "agent starting"

Was der Installer aufs Gerät legt

  • /usr/local/bin/poolpilot-relay – das Relay selbst, gestartet vom systemd-Dienst poolpilot-relay.
  • /usr/local/bin/poolpilot-relay-updater – der Update-Helfer. systemd startet ihn, wenn ein Update bereitliegt; von Hand rufst du ihn nie auf.
  • /etc/poolpilot-relay/config – die Konfigurationsdatei.
  • Die systemd-Units poolpilot-relay.service, poolpilot-relay-updater.service und poolpilot-relay-updater.path in /etc/systemd/system/.

Aktualisieren oder reparieren

Den Installer noch einmal auszuführen bringt das Relay auf die aktuelle Version und repariert eine kaputte Installation. Konfiguration und Kopplung bleiben erhalten:

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

Werksreset

Den Werksreset löst du in der PoolPilot App aus. Zwei Bedingungen gelten dabei bewusst: Nur der Besitzer darf ihn auslösen, und nur, wenn sein Handy im selben Netzwerk wie das Relay ist – von unterwegs geht das nicht.

Der Reset löscht Kopplung und Identität, und das Relay startet mit einer frischen Identität neu. Danach ist es entkoppelt: Entferne den alten Eintrag in der App, falls er noch da ist, und kopple es neu, als wäre es neu.

Relay entfernen

So deinstallierst du das Relay vollständig von einem Raspberry Pi oder Linux-Rechner:

# Dienst (und den Update-Watcher, falls vorhanden) stoppen und deaktivieren
sudo systemctl disable --now poolpilot-relay
sudo systemctl disable --now poolpilot-relay-updater.path 2>/dev/null || true

# Programme, systemd-Units, Konfiguration und Zustand entfernen
sudo rm -f /usr/local/bin/poolpilot-relay /usr/local/bin/poolpilot-relay-updater
sudo rm -f /etc/systemd/system/poolpilot-relay.service \
           /etc/systemd/system/poolpilot-relay-updater.service \
           /etc/systemd/system/poolpilot-relay-updater.path
sudo rm -rf /etc/poolpilot-relay /var/lib/poolpilot-relay /var/lib/poolpilot-relay-updater
sudo systemctl daemon-reload

Der Installer hat außerdem das systemd-Journal dauerhaft gemacht. Wenn du auch das rückgängig machen willst (optional):

sudo rm -f /etc/systemd/journald.conf.d/95-poolpilot-persistent.conf
sudo systemctl restart systemd-journald

In Home Assistant deinstallierst du einfach die App – lies vorher den Hinweis zu deinen Daten.

Immer noch hängen?

Öffne ein Issue im Relay-Repository und häng deine Logs an – schwärze vorher alles Sensible. Oder schau auf der Hilfe-Seite vorbei.

Relay-Repository & Doku