Anleitung

Relay einrichten – von null mit dem Raspberry Pi

Für alle, die noch nie bewusst mit Linux zu tun hatten. Wir richten einen Raspberry Pi mit dem Imager ein und installieren darauf das Relay – Schritt für Schritt.

ca. 30 Min Einsteigerfreundlich Zuletzt aktualisiert:

Diese Anleitung nimmt an, dass du bei null anfängst: kein Raspberry Pi, keine Linux-Erfahrung. Wir gehen gemeinsam durch, und wo du Kommandos eintippst, steht genau da, was sie tun.

Teil A – Den Raspberry Pi vorbereiten

Hardware bereitlegen

Du brauchst:

  • Einen Raspberry Pi 4 oder 5 (ein Pi 3 oder Pi Zero 2 W geht auch). Nicht geeignet: die ARMv6-Modelle Pi 1, Pi Zero und Pi Zero W.
  • Eine microSD-Karte (16 GB reichen locker) und ein Netzteil für den Pi.
  • Einen Computer (Windows, macOS oder Linux) mit SD-Kartenleser, um die Karte einmalig zu beschreiben.
  • Anschluss ans Netzwerk: LAN-Kabel ist am einfachsten, WLAN geht aber auch.

Ein Bildschirm und eine Tastatur für den Pi sind nicht nötig – wir richten ihn „headless“ (fernbedient) ein.

Raspberry Pi Imager installieren

Der Raspberry Pi Imager ist das offizielle Werkzeug, um das Betriebssystem auf die SD-Karte zu schreiben. Lade ihn dir auf deinem Computer von raspberrypi.com/software herunter und installiere ihn (es gibt ihn für Windows, macOS und Linux). Danach steckst du die microSD-Karte in den Kartenleser deines Computers und öffnest den Imager.

Raspberry Pi Imager, Bildschirm „Gerät wählen“: Liste der Pi-Modelle, „Raspberry Pi 3“ ist markiert.
Der Imager beim Start: zuerst wählst du unter „Gerät wählen“ dein Pi-Modell (danach folgen „OS wählen“ und „SD-Karte wählen“).

Betriebssystem wählen

Klick auf „OS wählen“ und wähl unter „Raspberry Pi OS (other)“ die Variante „Raspberry Pi OS Lite (64-bit)“. „Lite“ heißt: ohne Desktop-Oberfläche – genau richtig, das Relay läuft im Hintergrund und braucht keinen Bildschirm.

Raspberry Pi Imager, „OS wählen“: der Eintrag „Raspberry Pi OS (other)“ ist markiert.
Unter „OS wählen“ nach unten zu „Raspberry Pi OS (other)“.
Raspberry Pi Imager: „Raspberry Pi OS Lite (64-bit)“ ist ausgewählt.
Dort „Raspberry Pi OS Lite (64-bit)“ wählen – ohne Desktop, genau richtig fürs Relay.

Screenshot 1 von 2

Vor dem Schreiben: den Pi vorkonfigurieren

Das ist der wichtigste Schritt. Nach der Auswahl der SD-Karte klickst du auf „Weiter“ – der Imager führt dich jetzt durch die Einstellungen (in der Leiste links: Hostname, Localisation, Benutzer, WLAN, Fernzugriff). Damit ist der Pi beim ersten Start sofort erreichbar, ohne Bildschirm.

Stell hier ein:

  • Hostname: z.B. poolpilot-relay – darüber findest du den Pi später im Netzwerk.
  • Benutzername und Passwort: merk sie dir gut, damit meldest du dich später an.
  • WLAN: nur nötig, wenn du kein LAN-Kabel nutzt – trag SSID, Passwort und dein Land ein.
  • Zeitzone und Tastaturlayout: passend zu deinem Standort.
  • Im Schritt „Fernzugriff“ (SSH-Authentifizierung): SSH aktivieren und „Passwort-Authentifizierung verwenden“ wählen. SSH ist die Fernverbindung, über die wir den Pi gleich bedienen.
Raspberry Pi Imager, „SD-Karte wählen“: der SD-Kartenleser ist gelistet.
Zuerst deine microSD-Karte auswählen. Mit „Weiter“ geht’s weiter zu den Einstellungen.
Imager-Einstellungen, „Hostname“: das Feld enthält „poolpilot-relay“.
Hostname, z.B. „poolpilot-relay“ – darüber findest du den Pi später im Netzwerk.
Imager-Einstellungen, „Localisation“: Berlin, Zeitzone Europe/Berlin, Tastatur „de“.
Zeitzone und Tastaturlayout passend zu deinem Standort.
Imager-Einstellungen, „Benutzer“: Benutzername „benutzer“ und ein Passwort sind gesetzt.
Deine Wahl: „benutzer“ und „passwort“ sind nur Beispiele – trag deinen Wunsch-Benutzernamen und ein sicheres Passwort ein und merk sie dir gut.
Imager-Einstellungen, „WLAN“: SSID „Mein Heimnetz“ mit verdecktem Passwort.
Nur nötig ohne LAN-Kabel: SSID, WLAN-Passwort und dein Land eintragen.
Imager-Einstellungen, „SSH-Authentifizierung“: SSH ist aktiviert, „Use password authentication“ ist gewählt.
SSH an: „Passwort-Authentifizierung“ genügt für diese Anleitung. Public-Key-Auth wäre sicherer, sprengt hier aber den Rahmen.
Imager-Einstellungen, „Raspberry Pi Connect“: die Funktion ist ausgeschaltet.
„Raspberry Pi Connect“ brauchst du nicht – einfach aus lassen. Den Fernzugriff macht später das Relay.

Screenshot 1 von 7

Die microSD-Karte beschreiben

Klick auf „Schreiben“. Der Imager lädt das System, schreibt es auf die Karte und prüft es anschließend. Das dauert ein paar Minuten. Wenn er fertig meldet, kannst du die Karte auswerfen.

Imager, „Write image“: Zusammenfassung der gewählten Einstellungen.
Der Imager zeigt eine Zusammenfassung deiner Auswahl. Mit „Schreiben“ geht’s los.
Imager-Warnung: „You are about to ERASE all data“ mit „Cancel“ und „I understand, erase and write“.
Achtung: Die Karte wird komplett gelöscht. Vergewissere dich, dass die richtige Karte gewählt ist, dann bestätige.
Imager: Fortschrittsbalken „Writing…“.
Das System wird auf die Karte geschrieben …
Imager: Fortschrittsbalken „Verifying…“.
… und danach geprüft. Fertig – Karte auswerfen.

Screenshot 1 von 4

Den Pi starten und finden

Steck die microSD-Karte in den Pi, schließ (bei LAN) das Netzwerkkabel an und dann das Netzteil. Der erste Start dauert etwas länger – gib ihm ein, zwei Minuten.

Jetzt verbindest du dich von deinem Computer aus per SSH. Öffne ein Terminal (unter Windows die „Eingabeaufforderung“ bzw. PowerShell) und tippe – mit deinem Benutzernamen und Hostnamen:

ssh benutzer@poolpilot-relay.local

Beim allerersten Verbinden fragt SSH, ob du dem Gerät vertraust – bestätige mit yes und gib dann dein Passwort ein.

Teil B – Das Relay installieren

Installations-Befehl ausführen

Du bist jetzt per SSH auf dem Pi. 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, der automatisch startet. Kurz bevor er Systemrechte braucht, zeigt er dir die genauen Schritte und fragt nach deinem Passwort (dasselbe, das du im Imager gesetzt hast).

Teil C – Koppeln und prüfen

In der App koppeln

Öffne die PoolPilot App auf einem Smartphone im selben Netzwerk. Die App findet das Relay automatisch – folge den Hinweisen zum Koppeln.

Wird es nicht automatisch gefunden, lass dir den Kopplungscode auf dem Pi 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 im SSH-Fenster prüfst du Status und Logs:

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

Kurz nach dem Start sollte eine Zeile wie agent starting version=… erscheinen. Fertig – das Relay läuft, und je nach Poolsteuerung laufen jetzt Fernzugriff, Push und das Teilen darüber. Das Relay hält sich ab jetzt selbst aktuell; den Pi kannst du einfach laufen lassen.

Wenn etwas klemmt

Mehr Hilfe, alle Befehle und die Deinstallation findest du unter Hilfe & Befehle, Updates und Konfiguration unter Updates & Einstellungen.

Relay-Repository & Doku