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:
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¶
- Open Raspberry Pi Imager.
- Device: choose your Raspberry Pi model.
- Operating system: scroll down to Use custom and choose the downloaded file.
- Storage: choose the microSD card. All its contents will be erased.
-
Customisation: accept to edit the settings, then fill in:
Setting Recommended value Hostname etm-powersyncUsername 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.
-
Start writing and wait until the verification has finished.
3. First boot¶
- Insert the card, connect the Ethernet cable, then the power supply.
- Wait a few minutes. On first boot, the card is expanded to its real size and the Raspberry Pi reboots once: this is normal.
-
The box announces itself on the local network as
etm-powersync.local(the hostname chosen in Imager). From a computer on the same network:Failing that, look for
etm-powersyncin the list of devices connected to your internet router.
4. Check that the box responds¶
If you enabled SSH:
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: