HarmenandClaude Opus 5
a092464e4d
Vier punten van de gebruiker, opgekomen tijdens het beproeven met de testclient. De getimede leerstand is eruit; de wachtlijst is de enige weg naar binnen. Zijn redenering: allebei de wegen vragen iemand die bij de app kan, dus het is dubbelop, en het venster is de zwakste omdat het iedereen toelaat die er toevallig in verbindt. Dat weegt zwaarder nu de relay op een publiek wss-adres kan staan. De oorspronkelijke reden voor de leerstand, dat je je eigen OwnerId nergens kon aflezen, verviel toen de weigerlijst dat id ging tonen. Daarmee verdwijnt ook de bug die hij dezelfde dag meldde: een geleerde eigenaar bleef in de weigerlijst staan terwijl hij al kon schrijven en lezen, want decideOwner haalde hem niet van die lijst af en de knop allow wel. "Refused owners" heet "Waiting list", met de badge Waiting en een teller waar de widget van het tijdvenster stond. Het veld op schijf blijft rejected: hernoemen zou een migratie zijn voor een woord dat niemand ziet. Het adres onderaan zei http:// en dat kan nergens werken, want de relay spreekt WebSocket en nooit HTTP. Nu ws://<host>:3852, met een regel over wss://<domein> zonder poort achter een reverse proxy. Dat is precies de fout die diezelfde dag een ronde kostte bij het koppelen van de testclient. De melding bij elke klik is weg. Die stond in de gewone stroom van de pagina, dus alles eronder schoof omlaag en weer omhoog. Nu gaan de knoppen in de lijsten even op slot tot de ronde de nieuwe stand heeft; foutmeldingen blijven wel staan, want die zeggen iets wat je nergens anders ziet. STATE_VERSION blijft 1 en een owners.json van 0.6.0 leest door: learning en learningUntil worden gelezen, genegeerd en niet teruggeschreven. Een verhoging zou store.js de allowlist van een werkende installatie opzij laten schuiven. Twee toetsen bewaken dat de leerstand niet terugsluipt: een onbekende eigenaar wordt geweigerd ook met learning: true in het bestand, en set-learning is een onbekende actie. Beide mutatie-getest. De compose staat op 0.7.0 zonder digest, zodat het hard faalt tot de image bestaat. Bouwen, duwen en pinnen ligt bij de gebruiker. Suite: 424 goed, 0 fout. 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, one image, built from tools/electrum-gate/ by its build.sh
(nginx on alpine, plus python3). The app folder holds only the compose file, the manifest, the icon and
your data.
| Container | What it does |
|---|---|
server |
terminates TLS on 50022 and forwards plain to the Electrum server; serves the dashboard on port 80 behind the umbrelOS app proxy |
agent |
same image, different command; 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
Trezor Suite syncs labels and account names between devices, and by default that runs through a server operated by Trezor. That server is built on Evolu, and its relay is published as an npm package. This app runs that relay on your own machine, with an owner allowlist around it. 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, one image, built from tools/evolu-relay/ by its build.sh
(node on Debian slim, plus nginx and python3). The app folder holds only the compose file, the manifest,
the icon and your data.
| Container | What it does |
|---|---|
relay |
the sync relay, published on host port 3852; our src/index.js around @evolu/nodejs, adding the allowlist |
agent |
same image, different command; serves the status API and drops commands from the page into a mailbox the relay empties |
server |
same image; nginx serving the status page on port 80 behind the umbrelOS app proxy, with its sign-in |
The relay publishes its own port because a sync client is not a browser with a session cookie; the page sits behind the app proxy because it is. New owners are admitted only while a two-minute learning window is open on the page; everyone else is refused and listed, so you can allow them by hand.
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.