Skip to content

APT repository

To install ETM PowerSync on a Debian 13 ("trixie") 64-bit machine that is already running: mini-PC, server, virtual machine or Raspberry Pi under Raspberry Pi OS Lite 64-bit. Packages are published for amd64 and arm64.

These are exactly the steps used to build the Raspberry Pi image. Approximate time: about 10 minutes.

The channels

Channel Content
powersync-stable the channel to install: the stable release, one per quarter (What's new)
powersync-testing the trial channel: more recent, less proven versions

The commands below install the powersync-stable channel.

1. Required tools

A minimal Debian image does not always have them:

sudo apt update
sudo apt install -y curl gpg

2. Signing key

curl -fsSL https://repos.etm-powersync.fr/public.key | sudo gpg --dearmor -o /usr/share/keyrings/powersync.gpg

Check its fingerprint before trusting it:

gpg --show-keys --with-fingerprint /usr/share/keyrings/powersync.gpg

You must read PowerSync Repository <repo@etm-powersync.fr> and the fingerprint:

7703 3A6E ED63 EE91 FE92  98C3 A68A 697A 9D1B 4986

If it differs, delete the file (sudo rm /usr/share/keyrings/powersync.gpg), stop there and let us know.

3. Repository source

sudo tee /etc/apt/sources.list.d/powersync.sources > /dev/null <<'SRC'
Types: deb
URIs: https://repos.etm-powersync.fr
Suites: powersync-stable
Components: main non-free
Signed-By: /usr/share/keyrings/powersync.gpg
SRC

4. Installation

sudo apt update
sudo apt install -y powersync-core

apt update must list repos.etm-powersync.fr powersync-stable InRelease without a signature error. powersync-core installs nymea, the ETM PowerSync engine, the box's identity and the remote access client (disabled until you enable it in the app).

It also installs the device plugins validated by ETM, grouped in powersync-plugins-supported: SunSpec (including Fronius), Eastron meters, V2C Trydan charger (local HTTP API), generic meter, Open-Meteo, Tasmota, generic car. Nothing else to install for these devices.

5. Check that the box responds

systemctl is-active nymead      # expected: active
ss -ltn | grep -E ':(4444|2222) '

The second command must show ports 4444 (encrypted WebSocket, the one the app uses) and 2222 (TCP) listening.

The box announces itself on the local network under the machine's name (<name>.local): the app finds it by itself. On a virtual machine, prefer a bridged network to a NAT network, otherwise the phone cannot see it.

Updating

sudo apt update && sudo apt upgrade

Running sudo apt install powersync-core again does not update an engine that is already installed.

Changing channel

The channel is the word on the Suites: line of /etc/apt/sources.list.d/powersync.sources. To move from the trial channel to the stable channel:

sudo sed -i 's/^Suites: powersync-testing$/Suites: powersync-stable/' /etc/apt/sources.list.d/powersync.sources
sudo apt update && sudo apt upgrade

The other way round, swap the two words. From the trial channel to the stable channel, apt does not go back: newer packages already installed stay in place until the stable release catches up with them.

Next

First connection