Skip to content

Raspberry Pi image

The image contains Raspberry Pi OS Lite 64-bit (Debian 13 "trixie") with ETM PowerSync already installed (powersync-core, with the plugins of the validated devices). It contains no account and no password: you choose them when writing the card. The box's identity (serial number, certificate) is created at its first boot, so it is never shared between two boxes.

Channel

The 19 November 2026 image is built on the stable channel powersync-stable, the default channel, and is updated from it. To follow the testing channel, see Changing channel.

What you need

  • a compatible Raspberry Pi (see hardware) and its original power supply — a power supply that is too weak causes crashes that look like failures;
  • a microSD card of at least 8 GB, 16 GB recommended, preferably an "endurance" or industrial card: the box writes its history continuously;
  • an Ethernet cable connected to your internet router (or Wi-Fi, set in Imager);
  • a computer with Raspberry Pi Imager.

Approximate time: 15 to 20 minutes, including writing the card.

1. Download the image

Download the image and its .sha256 file from Downloads, into the same folder, then check the checksum:

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

On Windows: certutil -hashfile <file>.img.xz SHA256, to compare with the contents of the .sha256 file.

No need to decompress the image: Raspberry Pi Imager reads the .xz file directly.

2. Write the card

  1. Open Raspberry Pi Imager.
  2. Device: choose your Raspberry Pi model.
  3. Operating system: scroll down to Use custom and choose the downloaded file.
  4. Storage: choose the microSD card. All its contents will be erased.
  5. Customisation: accept to edit the settings, then fill in:

    Setting Recommended value
    Hostname etm-powersync
    Username and password your own — write them down
    Wi-Fi your network, or empty if the box is on Ethernet
    Time zone and keyboard your own (e.g. Europe/Paris, fr)
    SSH enable it if you want to administer the box from a computer

    Do not skip this step

    Without customisation, the first boot waits for an account to be entered on a screen and keyboard connected to the Raspberry Pi.

    This account is for administering the system (SSH). The app's accounts are created later, at the first connection.

  6. Start writing and wait until the verification has finished.

3. First boot

  1. Insert the card, connect the Ethernet cable, then the power supply.
  2. Wait a few minutes. On first boot, the card is expanded to its real size and the Raspberry Pi reboots once: this is normal.
  3. The box announces itself on the local network as etm-powersync.local (the hostname chosen in Imager). From a computer on the same network:

    ping etm-powersync.local
    

    Failing that, look for etm-powersync in the list of devices connected to your internet router.

4. Check that the box responds

If you enabled SSH:

ssh <user>@etm-powersync.local
systemctl is-active nymead     # expected: active

Without SSH, go straight to the first connection: the box should appear under Found on this network.

Updating

The image uses the same repository as the APT installation:

sudo apt update && sudo apt upgrade

Next

First connection