PoolPilot Relay

🇩🇪 Deutsch · 🇬🇧 English version below

Ein kleines Programm für zu Hause, das deine Poolsteuerung mit der PoolPilot-App verbindet — auch von unterwegs.

Was es für deinen Pool tut

Was du davon hast	ProCon.IP	BADU Blue	VIOLET
Pool zu Hause im WLAN steuern	geht ohne Relay	geht ohne Relay	geht ohne Relay
Pool von unterwegs steuern	✓ mit Relay	kann sie schon	kann sie schon
Push aufs Handy, wenn etwas nicht stimmt	✓ mit Relay	✓ mit Relay	kann sie schon*
Pool mit der Familie teilen — inkl. Pro-Funktionen, bis zu 10 Geräte, iPhone und Android gemischt	✓ mit Relay	✓ mit Relay	✓ mit Relay

* Kostenlos in PoolPilot — das Relay kann es optional übernehmen.

Kurz gesagt:

• ProCon.IP: Das Relay macht sie fit für unterwegs.
• BADU Blue: Das Relay bringt Push in PoolPilot.
• VIOLET: Das Relay brauchst du nur zum Teilen.

Was brauchst du dafür? Ein Gerät, das bei dir zu Hause immer läuft (z. B. ein Raspberry Pi oder dein Home Assistant) und PoolPilot Pro.

Installation

Auf einem Raspberry Pi oder einem anderen Linux-Rechner:

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

Danach öffnest du die PoolPilot-App im selben WLAN und koppelst das Relay. Ab dann aktualisiert es sich von selbst. Lieber erst lesen, was du ausführst? Der Installer liegt offen in diesem Repo: deploy/relay/install.sh.

Mit Home Assistant: Füge dieses Repo unter Einstellungen → Add-ons → Add-on-Store → ⋮ → Repositories hinzu und installiere PoolPilot Relay:

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

Danach koppelst du es aus der App. Updates kommen wie bei jeder anderen Home-Assistant-App über den Store.

Dokumentation

Seite	Inhalt
Installation & Kopplung	Voraussetzungen, der Installer, erste Kopplung
Home-Assistant-App	Das Relay als Home-Assistant-App statt auf einem Pi betreiben
Befehle	Die Programme, die das Relay installiert, und wie du sie aufrufst
Konfiguration	Die Datei /etc/poolpilot-relay/config
Selbst-Update	Wie automatische Updates funktionieren und wie du sie steuerst
Fehlerbehebung	Logs, neu koppeln, Wiederherstellung, neu installieren, entfernen
Sicherheit & Datenschutz	Was wo gespeichert ist, Netzwerk und Ports, der Tunnel, signierte Versionen

Fragen oder ein Problem? Issue anlegen · Website: poolpilot.eu

Für Entwickler

Open Source (MIT), in Go geschrieben. Die Binaries erscheinen als signierte GitHub Releases, das Home-Assistant-Image auf ghcr.io. Bauen und testen mit go build ./..., go test ./... und go vet ./... — mehr dazu im englischen Teil.

---

🇩🇪 Deutsche Version oben · 🇬🇧 English

A small program for your home that connects your pool controller to the PoolPilot app — even while you're away.

What it does for your pool

What you get	ProCon.IP	BADU Blue	VIOLET
Control your pool at home over Wi‑Fi	works without the Relay	works without the Relay	works without the Relay
Control your pool while you're away	✓ with the Relay	built in	built in
Push to your phone when something's off	✓ with the Relay	✓ with the Relay	built in*
Share your pool with your family — Pro features included, up to 10 devices, iPhone and Android mixed	✓ with the Relay	✓ with the Relay	✓ with the Relay

* Free in PoolPilot — the Relay can optionally take it over.

In short:

• ProCon.IP: the Relay gets it ready for when you're away.
• BADU Blue: the Relay brings push to PoolPilot.
• VIOLET: you only need the Relay for sharing.

What do you need? A device that's always on at home (e.g. a Raspberry Pi or your Home Assistant) and PoolPilot Pro.

Install

On a Raspberry Pi or any other Linux machine:

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

Then open the PoolPilot app on the same Wi‑Fi and pair the Relay. From then on it updates itself. Prefer to read what you run first? The installer is right here in this repo: deploy/relay/install.sh.

With Home Assistant: add this repo under Settings → Add-ons → Add-on store → ⋮ → Repositories and install PoolPilot Relay:

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

Then pair it from the app. Updates arrive through the store, like for any other Home Assistant app.

Documentation

Page	What it covers
Installation & pairing	Requirements, the installer, first pairing
Home Assistant app	Running the Relay as a Home Assistant app instead of on a Pi
Commands	The programs the Relay installs and how to run them
Configuration	The /etc/poolpilot-relay/config file
Self-update	How automatic updates work and how to control them
Troubleshooting	Logs, re-pairing, recovery, reinstalling, removing
Security & privacy	What is stored where, network and ports, the tunnel, signed releases

Questions or a problem? Open an issue · Website: poolpilot.eu

For developers

The edge agent is one Go module at the repo root. It talks to the controller on the local network and reaches the PoolPilot cloud through an outbound tunnel when you're away.

go build ./...     # compile every package
go test ./...      # unit + wire/measurement parity tests
go vet ./...       # static checks

• Releases: binaries are published as signed GitHub Releases. The installer checks each download's SHA-256 checksum, plus a minisign signature when minisign is installed. The PoolPilot control plane decides which version installs.
• Home Assistant app: lives in poolpilot_relay/. Its multi-arch image is published to ghcr.io on every release tag by addon-release.yml.
• Self-update testing: a manual end-to-end harness per architecture (QEMU or cloud-init VMs on amd64/386/armv7/riscv64) lives in test/self-update-e2e/.

License: MIT · see also NOTICE.