UmbrelApps/whatsnext-evolu-relay/umbrel-app.yml

# De veldvolgorde hieronder is niet vrij: de packaging-documentatie van de
# officiele appstore schrijft hem voor. Zie de tabel in
# Docs/Referenties/Umbrel-appstore-spec.md.
#
# Wat de spec niet noemt staat onderaan dit bestand en niet ertussen. Dan is de
# voorgeschreven kop letterlijk goed en hoeft er bij inlevering alleen iets weg.
#
# `dependencies` is weggelaten en niet leeg gezet: deze app hangt van geen enkele
# andere app af. Een leeg veld zou suggereren dat er iets te kiezen valt.
manifestVersion: 1
id: whatsnext-evolu-relay
category: bitcoin
name: Evolu Relay
version: "0.2.1"
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
  devices. By default that runs through a server operated by Trezor. This app runs that
  server on your Umbrel instead, so the sync goes through a machine you own.


  The data is end to end encrypted on your device before it leaves, so Trezor cannot read
  your labels either way. What self-hosting changes is who holds the encrypted copy and who
  can see that you are syncing at all.


  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.
releaseNotes: >-
  Fixes a status page that alternated between working and showing an error. It reached its helper by a
  short name that another app in this store uses as well, so about half of its requests ended up at the
  wrong app. It now uses a name that is unique to this one.


  Earlier releases:


  0.2.0 was 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.


  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.


  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: 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. 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
# Gate een keer een dag gekost, met 50002 tegen Fulcrum. 3851 sluit aan op de 3850
# van die app.
port: 3851
# Leeg laten bij een nieuw pakket; de plaatjes doet het store-team zelf.
gallery: []
path: ""
submitter: "WhatsNext?"
submission: https://sc.kamenier-hamer.nl/sysop/UmbrelApps

# ── Hieronder staat wat de voorgeschreven volgorde niet noemt ────────────────
#
# Het icoon, sinds 28-08-2026. Het bestand staat in deze repo en wordt door Gitea
# rauw uitgeleverd; dezelfde constructie als bij Electrum Gate. Bij inlevering in
# de officiële store moet deze regel juist weg, want die host iconen apart.
# Daarom staat hij als laatste: dan is het één regel schrappen.
icon: https://sc.kamenier-hamer.nl/sysop/UmbrelApps/raw/branch/main/whatsnext-evolu-relay/icon.png

# Wat niet in de back-up hoeft. Paden zijn relatief aan de app-datamap.
#
# Voor deze app is dat vrijwel niets, en dat is expres: de database ís de waarde
# van de app. Electrum Gate gebruikt dit veld wel, maar daar gaat het om een log
# en een statusbestand. Neem die keuze hier niet uit gewoonte over.
backupIgnore: []