Relay-Doku

Das Relay als Home-Assistant-App

Läuft bei dir schon Home Assistant? Dann kann das Relay direkt darin wohnen – ganz ohne separaten Rechner. Gleiches Relay, gleiche Kopplung, gleiche Funktionen.

ca. 2 Min Einsteigerfreundlich Zuletzt aktualisiert:

Voraussetzungen

Repository hinzufügen

Öffne in Home Assistant Einstellungen → Add-ons → Add-on-Store, dann oben rechts das ⋮-Menü → Repositories, und füge diese Adresse hinzu:

https://github.com/ylabonte/poolpilot-relay

Relay installieren

Such im Store nach PoolPilot Relay, öffne es und wähle Installieren. Home Assistant lädt ein fertiges Image – auf deinem Gerät wird nichts gebaut.

Einstellungen prüfen – vor dem Koppeln

Im Reiter Konfiguration der App gibt es genau zwei Einstellungen:

  • LAN-Port (lan_port, Standard 8443): der Port, über den die PoolPilot App das Relay zu Hause erreicht. Ändere ihn nur, wenn eine andere App 8443 schon belegt – im Log steht dann bind: address already in use.
  • Zusätzliche mDNS-Logs (mdns_verbose_logs, standardmäßig aus): blendet harmlose Hinweise der Discovery-Bibliothek wieder ein. Nur zum Fehlersuchen gedacht.

Starten und in der App koppeln

Starte die App in Home Assistant. Öffne dann die PoolPilot App auf einem Smartphone im selben Netzwerk: Das Relay kündigt sich per mDNS an, die App findet es automatisch und führt dich durch die Kopplung. Die Konsole der Home-Assistant-App musst du dafür nicht anfassen.

Mehr zum Koppeln und Teilen steht unter Koppeln & Haushalt.

Deine Daten und Backups

Kopplung, Registrierung der Poolsteuerung und die TLS-Identität des Relays liegen auf dem eigenen, dauerhaften Speicher der App (/data):

  • Sie überstehen Neustarts und App-Updates von selbst.
  • Sie sind in deinen Home-Assistant-Backups enthalten.

Die TLS-Identität ist das, worauf deine gekoppelten Handys vertrauen. Geht sie verloren, müssen alle Handys neu koppeln.

Updates

Updates kommen hier über den Add-on-Store, wie bei jeder anderen Home-Assistant-App. Den Update-Ablauf steuert der Supervisor – das Relay aktualisiert sich in Home Assistant deshalb nicht selbst. Wie die Updates auf einem Raspberry Pi laufen, steht unter Updates & Einstellungen.

App entfernen

Wenn etwas klemmt

  • Die App findet das Relay nicht: Ist die Home-Assistant-App gestartet? Sind Home Assistant und dein Handy im selben Netzwerk? Ist der Port (Standard 8443) frei?
  • Im Log steht bind: address already in use: Eine andere App belegt den Port. Setz im Reiter Konfiguration einen anderen lan_port und starte die App neu. War das Relay schon gekoppelt, beachte den Hinweis zum Port oben.
  • Logs ansehen: im Reiter Log der App.
  • Wiederkehrende RFC6762-Zeilen im Log sind harmlos – mehr dazu unter Hilfe & Befehle.

Für Fortgeschrittene: Kopplungs- und Wiederherstellungscode

Normalerweise brauchst du das nicht – die App findet das Relay von selbst. Falls doch: Die Befehle show-pairing (Kopplungscode) und show-recovery (Besitzer-Wiederherstellungscode) laufen im Container des Relays. Das Image hat keine eigene Shell, und Home Assistant hat keinen „Exec“-Knopf für Apps. Du brauchst also eine Shell auf dem Host, zum Beispiel über die App SSH & Web Terminal mit ausgeschaltetem Protection Mode. Der Containername enthält die ID des Repositorys, deshalb sucht der Befehl ihn per Teilstring:

docker exec "$(docker ps --filter name=poolpilot_relay --format '{{.Names}}')" \
  /usr/local/bin/poolpilot-relay show-pairing

Für den Wiederherstellungscode ersetzt du show-pairing durch show-recovery.

Die App läuft im Host-Netzwerk, damit sie sich per mDNS ankündigen, deine Poolsteuerung im lokalen Netz erreichen und den Port für die PoolPilot App öffnen kann. Welche Verbindungen das Relay sonst aufbaut, steht unter Technik & Sicherheit.

Relay-Repository & Doku