Raspberry-Pi-Image¶
Das Image enthält Raspberry Pi OS Lite 64 Bit (Debian 13 „trixie“) und ETM PowerSync, bereits
installiert (powersync-core, mit den Plugins der validierten Geräte). Es enthält weder Konto
noch Passwort: Sie legen sie beim Beschreiben der Karte fest. Die Identität der Box
(Seriennummer, Zertifikat) entsteht bei ihrem ersten Start und wird daher nie zwischen zwei Boxen
geteilt.
Kanal
Das Image vom 19. November 2026 ist auf dem stabilen Kanal powersync-stable gebaut, dem
Standardkanal, und wird aus ihm aktualisiert. Um dem Testkanal zu folgen, siehe
Den Kanal wechseln.
Was Sie brauchen¶
- einen kompatiblen Raspberry Pi (siehe Hardware) und sein Originalnetzteil — ein zu schwaches Netzteil verursacht Abstürze, die wie Defekte aussehen;
- eine microSD-Karte mit mindestens 8 GB, 16 GB empfohlen, möglichst eine „Endurance“- oder Industriekarte: Die Box schreibt ihre Historie ständig;
- ein Ethernet-Kabel zu Ihrem Router (oder WLAN, im Imager eingestellt);
- einen Computer mit Raspberry Pi Imager.
Richtwert: 15 bis 20 Minuten, Schreiben der Karte inklusive.
1. Das Image herunterladen¶
Laden Sie das Image und seine .sha256-Datei unter Downloads in
denselben Ordner und prüfen Sie dann die Prüfsumme:
Unter Windows: certutil -hashfile <Datei>.img.xz SHA256, mit dem Inhalt der .sha256-Datei
vergleichen.
Das Image muss nicht entpackt werden: Raspberry Pi Imager liest die .xz-Datei direkt.
2. Die Karte beschreiben¶
- Öffnen Sie Raspberry Pi Imager.
- Gerät: Wählen Sie Ihr Raspberry-Pi-Modell.
- Betriebssystem: Scrollen Sie bis Eigenes Image („Use custom“) und wählen Sie die heruntergeladene Datei.
- Speicher: Wählen Sie die microSD-Karte. Ihr gesamter Inhalt wird gelöscht.
-
Anpassung: Stimmen Sie dem Bearbeiten der Einstellungen zu und tragen Sie ein:
Einstellung Empfohlener Wert Hostname etm-powersyncBenutzername und Passwort Ihre eigenen — notieren Sie sie WLAN Ihr Netz, oder leer, wenn die Box per Ethernet angeschlossen ist Zeitzone und Tastatur Ihre eigenen (z. B. Europe/Berlin,de)SSH aktivieren, wenn Sie die Box von einem Computer aus administrieren wollen Diesen Schritt nicht überspringen
Ohne Anpassung wartet der erste Start auf die Eingabe eines Kontos an einem Bildschirm und einer Tastatur, die am Raspberry Pi angeschlossen sind.
Dieses Konto dient zur Administration des Systems (SSH). Die Konten der App werden später angelegt, bei der ersten Verbindung.
-
Starten Sie das Schreiben und warten Sie das Ende der Überprüfung ab.
3. Erster Start¶
- Stecken Sie die Karte ein, schließen Sie das Ethernet-Kabel und dann das Netzteil an.
- Warten Sie einige Minuten. Beim ersten Start wird die Karte auf ihre tatsächliche Größe vergrößert und der Raspberry Pi startet einmal neu: Das ist normal.
-
Die Box meldet sich im lokalen Netz unter dem Namen
etm-powersync.local(dem im Imager gewählten Hostnamen). Von einem Computer im selben Netz:Andernfalls suchen Sie
etm-powersyncin der Liste der verbundenen Geräte Ihres Routers.
4. Prüfen, ob die Box antwortet¶
Wenn Sie SSH aktiviert haben:
Ohne SSH gehen Sie direkt zur ersten Verbindung: Die Box muss unter In diesem Netzwerk gefunden erscheinen.
Aktualisieren¶
Das Image nutzt dasselbe Repository wie die Installation über APT: