HarmenandClaude Opus 5
c80d587100
De gebruiker vroeg of iemand met kennis van de API zijn labels kan opvragen zodra de relay op een domein staat. Nee, en de reden is scherper dan "het is versleuteld". Uit een OwnerSecret worden met SLIP-21 drie onafhankelijke waarden afgeleid: een publieke OwnerId, een encryptiesleutel en een rotatable write key. Alleen de eerste gaat naar de relay. Het aardige is dat de OwnerId expres niet geheim is. De beveiliging leunt er niet op dat je adres onbekend blijft, en dat is het tegenovergestelde van een systeem waar een onraadbare URL de grens vormt. Daarom kan deze relay bij een onbekende partij staan. Twee dingen expres niet gladgestreken. Of iemand die een OwnerId kent de versleutelde blobs kan ophalen staat nergens gedocumenteerd; kan het, dan lekt dat bestaan, activiteit en bij benadering omvang, niet inhoud. En onraadbaarheid van de OwnerId beschermt tegen het aflopen van een relay, niet tegen lezen. Dat verschuift waar Bereikbaarheid over gaat. Het risico van een open eindpunt is misbruik als gratis versleutelde opslag: een kale relay kent geen accounts en kan per definitie niet weten van wie de data is. Dat is met terugwerkende kracht de tweede functie van Trezor's quota-manager, naast facturering, en die haalden wij eruit. Het voorstel van de gebruiker voor een eigen quota-manager met een allowlist van OwnerId's staat erin, met drie uitvoeringen en hun prijs. De netste is createRelay uit @evolu/nodejs, dat auth expliciet als reden noemt om die API te gebruiken, maar dan bouw je weer een eigen image en verlies je de winst van de gepubliceerde. Met een detail dat het lastiger maakt dan het klinkt: je moet je eigen OwnerId kennen om hem te vlaggen, en Suite toont die waarschijnlijk nergens. Uitweg is niet laten typen maar laten leren: de eerste eigenaar die verbindt wordt toegelaten. Meegenomen uit de vorige bevinding: open punt 2 is beantwoord, Suite eist geen TLS. Tests: niet gedraaid, dit raakt alleen documentatie. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
UmbrelApps
A community app store for Umbrel, store id whatsnext. Add it in umbrelOS under
App Store → Community App Stores, using the clone URL of this repository.
Apps
Electrum Gate
Reach your own Electrum server from outside your network, over TLS. An Electrum server speaks plain TCP; a wallet on the road wants TLS. This app puts a proxy in between, using the certificate a reverse proxy on the same Umbrel already manages.
Two containers, both on an off-the-shelf image, both configured from a *.template.
| Container | What it does |
|---|---|
server (nginx:alpine) |
terminates TLS on 50022 and forwards plain to the Electrum server; serves the dashboard on port 80 behind the umbrelOS app proxy |
agent (python:3-alpine) |
writes status.json every minute, reads the certificates from the mounted folders, queries the Electrum server, and accepts the certificate choice |
The agent cannot reload nginx itself, as that would need the Docker socket and it is deliberately absent.
It writes cert.conf with the chosen paths and drops a flag file; the nginx container reloads itself. A
reload keeps existing wallet connections alive.
| Port | For |
|---|---|
| 50022 | TLS for Electrum wallets. Not the conventional 50002: Fulcrum occupies that on the host, and with Fulcrum as the backend the container would not start |
| 3850 | the web UI, through the umbrelOS app proxy |
Electrs, Fulcrum and ElectrumX all work, switchable in the umbrelOS settings: the app declares the dependency and uses the address it is handed. Details, with sources, in Docs/Referenties/Umbrel-appstore-spec.md §4.
Tor or TLS. The privacy win is in running your own server, and you have that the moment you do. Tor remains the better choice for privacy; TLS wins on speed, on mobile, and on networks that block Tor. The trade-off is written out in Docs/Referenties/Clients.md §1.
Evolu Relay
Packaged, never installed. The manifest and compose are here; nothing has run on an Umbrel yet.
Trezor Suite syncs labels and account names between devices, and by default that runs through a server operated by Trezor. That server is open source and called Evolu Relay. This app runs it on your own machine. The data is end to end encrypted on the device, so self-hosting does not change that guarantee, it only changes who holds the encrypted copy.
Three containers, two images.
| Container | What it does |
|---|---|
relay |
the sync relay on 4000, reached through the app proxy on 3851 |
quota-manager |
same image, different command; registers the storage limit the relay requires |
db (postgres:17-alpine) |
storage, under ${APP_DATA_DIR}/data/postgres |
The app proxy runs with PROXY_AUTH_ADD: "false", because Trezor Suite is not a browser with a session
cookie. That is the same pattern Umbrel's own nostr-relay app uses. The flip side: anything that can reach
port 3851 reaches the relay without signing in. What limits the damage is that the relay refuses any owner
without a storage limit registered in its database.
Trezor publishes no image, so it is built from their Dockerfile, pinned to a commit, by tools/evolu-relay/build.sh. Run that before installing.
Still unverified: whether Trezor Suite accepts this address, whether the database schema creates itself, and how an owner gets registered. See Docs/Referenties/Upstream-evolu-relay.md.
Documentatie
Alles staat in Docs/. Begin bij Docs/CONTINUE_HERE.md; dat is de index die naar de volgende stap wijst.
| Waar je heen wilt | Waar het staat |
|---|---|
| Wat er nu speelt en wat de volgende stap is | Docs/CONTINUE_HERE.md |
| Wat umbrelOS van een app store verwacht | Docs/Referenties/Umbrel-appstore-spec.md |
| Hoe Electrum Gate vandaag in elkaar zit | Docs/Referenties/Architectuur-huidig.md |
| Welke wallets hierheen kunnen wijzen, en wanneer Tor beter is | Docs/Referenties/Clients.md |
| Wat er over de sync-server van Trezor bekend is | Docs/Referenties/Upstream-evolu-relay.md |
| Versiegeschiedenis van Electrum Gate | Docs/CHANGELOG-electrum-gate.md |
| Waar documentatie hoort | Docs/README.md |
Tests
python tests/test_appstore_vorm.py
Die gaat over de store en vindt zijn apps zelf: id gelijk aan mapnaam, store-voorvoegsel, veldvolgorde in
het manifest, en een app_proxy die naar een bestaande service wijst. Daarnaast twee suites voor Electrum
Gate:
python tests/test_agent_certificates.py
Losse scripts, geen afhankelijkheden. Let op de regels met OVERGESLAGEN: die toetsen hebben de
certificaatwinkel van het besturingssysteem of netwerk nodig, en zijn dan niet bewezen.
Licentie
De apps zijn dunne lagen om bestaande onderdelen: nginx en Alpine Linux (BSD/MIT) voor Electrum Gate, en straks de relay van Trezor, die zijn eigen licentie houdt. Voor de verpakking zelf is nog geen licentie gekozen.