Zum Inhalt

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:

sha256sum -c etm-powersync-pi-stable-*-arm64.img.xz.sha256

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

  1. Öffnen Sie Raspberry Pi Imager.
  2. Gerät: Wählen Sie Ihr Raspberry-Pi-Modell.
  3. Betriebssystem: Scrollen Sie bis Eigenes Image („Use custom“) und wählen Sie die heruntergeladene Datei.
  4. Speicher: Wählen Sie die microSD-Karte. Ihr gesamter Inhalt wird gelöscht.
  5. Anpassung: Stimmen Sie dem Bearbeiten der Einstellungen zu und tragen Sie ein:

    Einstellung Empfohlener Wert
    Hostname etm-powersync
    Benutzername 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.

  6. Starten Sie das Schreiben und warten Sie das Ende der Überprüfung ab.

3. Erster Start

  1. Stecken Sie die Karte ein, schließen Sie das Ethernet-Kabel und dann das Netzteil an.
  2. 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.
  3. 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:

    ping etm-powersync.local
    

    Andernfalls suchen Sie etm-powersync in der Liste der verbundenen Geräte Ihres Routers.

4. Prüfen, ob die Box antwortet

Wenn Sie SSH aktiviert haben:

ssh <benutzer>@etm-powersync.local
systemctl is-active nymead     # erwartet: active

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:

sudo apt update && sudo apt upgrade

Weiter

Erste Verbindung