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:
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:
You must read PowerSync Repository <repo@etm-powersync.fr> and the fingerprint:
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¶
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¶
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¶
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.