Het pakket omgebouwd: kale relay, statuspagina, poorten omgedraaid

De app-map is niet langer de relay van Trezor met een Postgres en een
quota-manager ernaast, maar de relay van Evolu met onze eigen allowlist eromheen.
Drie containers werden relay, agent en nginx; het wachtwoord en de database zijn
verdwenen.

De poorten zijn omgedraaid en dat is de kern. Tot 0.0.2 hing de relay achter
app_proxy en moest de inlog van umbrelOS dus uit, waardoor een statuspagina net zo
onbeschermd zou zijn als de relay zelf. Nu hangt de pagina daar met de inlog aan,
en publiceert de relay zijn eigen poort 3852 waar Zoraxy met TLS naartoe wijst.
Dat is hetzelfde patroon als Electrum Gate met 50022. Niet 4000 op de host, want
dat is een veelgebruikte poort en een botsing merk je pas als de app niet start.

De agent beslist niets: hij leest wat het relay-proces heeft opgeschreven en legt
opdrachten in een postbus die de relay zelf leegmaakt. Twee processen die in
dezelfde allowlist schrijven is een wedloop die je een keer per jaar treft en dan
niet kunt reproduceren. Hij weigert ook een tweede opdracht zolang de vorige er
nog ligt, want overschrijven zou er stil een laten verdwijnen.

De pagina volgt het ontwerpsysteem van Electrum Gate, zonder de Google
Fonts-verwijzing daaruit: een app op een Umbrel hoort niet te wachten op een
lettertype van buiten. Alles is met stringoptelling geschreven en zonder enig
dollarteken, want umbreld haalt elke template door envsubst en zou een
JavaScript-template-literal stilzwijgend leegmaken.

De image is door de gebruiker gebouwd en geduwd; de compose is gepind op tag plus
digest. Manifest naar 0.2.0, met een beschrijving en releaseNotes die kloppen met
wat er nu draait in plaats van met het vorige pakket.

Wat hier NIET mee bewezen is, en dat is meer dan gebruikelijk: de agent is alleen
op syntaxis gecontroleerd, de pagina is nooit gerenderd, en of een opdracht van de
pagina daadwerkelijk bij het relay-proces aankomt is niet gemeten. Dat kan alleen
op het apparaat en staat als taak.

Tests: alle vier groen (32, 54, 39 en 60 goed, 0 fout).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Harmen
2026-08-28 11:22:32 +02:00
co-authored by Claude Opus 5
parent a738f6c0f1
commit 576acd20dd
8 changed files with 963 additions and 147 deletions
+27 -23
View File
@@ -11,7 +11,7 @@ manifestVersion: 1
id: whatsnext-evolu-relay
category: bitcoin
name: Evolu Relay
version: "0.0.2"
version: "0.2.0"
tagline: Sync your Trezor Suite labels through your own machine
description: >-
Trezor Suite can sync the labels and account names you give your addresses across your
@@ -24,43 +24,47 @@ description: >-
can see that you are syncing at all.
This is Trezor's own relay, not a reimplementation: it is built from the source they publish
as trezor/trezor-suite-sync, pinned to a specific commit.
This runs the relay from the Evolu project, the sync layer Trezor Suite is built on, taken
straight from the package they publish. Nothing about it is reimplemented here. What this app
adds is the part a self-hosted relay needs and an open one does not: control over who may use
it.
The tile opens a status page. It shows whether the relay is running, how much it stores, and
which devices are allowed. New devices are accepted one at a time: the first owner that
connects is remembered, and you close the door again once your own devices are paired. Any
owner can be blocked or removed later from that same page.
Point Trezor Suite at this Umbrel to use it. Away from home you will need a way in, such as
Tailscale or a reverse proxy with your own domain.
Two things to know before you install. The relay has no web interface, so the tile opens the
relay itself rather than a page for you to read. And it only serves an owner that has a
storage limit registered in its database, which is what the included quota manager is for;
if syncing is refused, that registration is the place to look.
releaseNotes: >-
First release that can actually be installed. 0.0.1 pointed at an image that only existed
on the machine it was built on, and the install failed before anything started: umbrel
fetches every image from a registry, so a local build is out of reach. The image now comes
from a registry and is pinned to its digest.
A different relay, and a much smaller app. 0.0.2 packaged the relay Trezor runs for their own
hosted service, with a quota manager and a PostgreSQL database beside it. That combination
cannot work on your own machine: Suite skips the quota manager as soon as you point it at a
relay of your own, while that relay refuses every owner the quota manager never registered.
Packages Trezor's Evolu Relay, the quota manager it needs, and a PostgreSQL database, all on
your own machine.
This release uses the relay from the Evolu project instead, which Trezor Suite talks to
directly. Measured, not assumed: Suite sent labels to it and they arrived. The database and
the quota manager are gone, and three containers became one relay plus a status page.
Built from source pinned to commit c03a204 of trezor/trezor-suite-sync. There is no image
published by Trezor, so the image is built from their Dockerfile; see tools/evolu-relay in
the app store repository.
New: a status page behind your umbrelOS login, and control over who may sync. The first owner
that connects is remembered and accepted; after that you close the door, and anything new is
refused until you open it again.
Not verified yet: whether Trezor Suite accepts this address, and what has to happen before
an owner is allowed to sync.
Not verified yet: reading back from a second device, and whether the iOS app can use a relay
of your own at all.
developer: "WhatsNext?"
website: https://sc.kamenier-hamer.nl/sysop/UmbrelApps
repo: https://sc.kamenier-hamer.nl/sysop/UmbrelApps
support: https://sc.kamenier-hamer.nl/sysop/UmbrelApps/issues
# De poort waarop umbrelOS deze app aanbiedt, en tegelijk de poort waar Trezor
# Suite naartoe wijst: de app-proxy staat met PROXY_AUTH_ADD op "false", dus wat
# hier binnenkomt gaat rechtstreeks naar de relay. Zie docker-compose.yml.
# De poort waarop umbrelOS deze app aanbiedt. Sinds 0.1.0 is dat de STATUSPAGINA
# en niet de relay: de app-proxy zet er de inlog van umbrelOS voor, en daar hoort
# een pagina wel achter en een relay niet. Trezor Suite wijst naar 3852, die de
# relay zelf publiceert. Zie docker-compose.yml en het plan Umbrelapp, PLAN.md §4h.
#
# Niet 4000, de eigen poort van de relay: die is een veelgebruikte poort en een
# botsing op de host merk je pas als de app niet start. Dat heeft bij Electrum