HarmenandClaude Opus 5
b2e9c8fc7a
De gebruiker koos ervoor het pakket meteen te maken en een installatie te proberen, met de image lokaal gebouwd en het recept in de repo. Dit is dat pakket. Er is nog niets gebouwd en niets geinstalleerd; "gebouwd" is hier nadrukkelijk niet "werkend". De zwaarste ontwerpvraag is met een precedent beslecht en niet met een gok. Trezor Suite is geen browser met een sessiecookie en kan dus niet achter de inlog van umbrelOS; het was onduidelijk of PROXY_AUTH_ADD "false" dan verantwoord is of een omweg. De eigen nostr-relay-app van Umbrel doet exact hetzelfde, om precies dezelfde reden, en heeft ook geen eigen ports:. De prijs staat in de compose en in het plan: wie die poort bereikt, bereikt de relay. Wat de schade beperkt is dat de relay elke eigenaar zonder limietenrij weigert. Daarom gaat de quota-manager mee, en dat is geen restje van Trezor's betaalde hosting: hij is wat die rijen aanmaakt. Relay en quota-manager komen uit dezelfde image met een ander command, want bovenstrooms is het een codebase met meerdere startscripts. Het command staat expliciet en leunt niet op de CMD van de Dockerfile, waar yarn start staat met bovenstrooms zelf een twijfel erbij. Het bouwrecept staat in tools/ en niet in de app-map. Dat is geen netheid: een Dockerfile staat niet in de update-whitelist, dus bouwen-in-de-app zou elke nieuwe versie een deinstallatie plus herinstallatie kosten. Onder tools/ en niet onder build/, want dat laatste staat in .gitignore als bouwselmap en het recept zou stilzwijgend buiten de repo zijn gebleven. Dat kwam pas bij git status aan het licht. De poort is 3851 en niet 4000. 4000 is de eigen poort van de relay maar ook een veelgebruikte poort, en een botsing op de host merk je pas als de app niet start. Die les komt van 50002 tegen Fulcrum. Nieuw testbestand test_appstore_vorm.py, en het gaat over de store en niet over een app: id gelijk aan mapnaam, store-voorvoegsel, veldvolgorde, app_proxy die naar een bestaande service wijst, en elke gemounte map die in de repo bestaat. Het vindt zijn apps zelf, dus een derde app valt er automatisch onder. Digests toetst het expres niet: geen van de twee apps haalt die regel vandaag en een suite die altijd rood staat wordt niet gelezen. Mutatie-getest met drie ingrepen: het app-id laten afwijken van de mapnaam, APP_HOST naar een niet-bestaande service laten wijzen, en de .gitkeep weghalen. Alle drie vielen om bij de juiste toets, en git diff was daarna leeg. Umbrelapp is gepromoveerd naar Actief als 008, tussen Proefopstelling en Appstore, en het masterplan is naar het archief. Wat er in de plannen als open blijft staan is niet klein: of Trezor Suite dit adres accepteert, of het databaseschema zichzelf aanmaakt, en hoe je een eigenaar registreert. Tests: 32 goed 0 fout, 39 goed 0 fout en 54 goed 0 fout, niets overgeslagen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
104 lines
5.2 KiB
Markdown
104 lines
5.2 KiB
Markdown
# UmbrelApps
|
|
|
|
A community app store for [Umbrel](https://umbrel.com), 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](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](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](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](Docs/Referenties/Upstream-evolu-relay.md).
|
|
|
|
## Documentatie
|
|
|
|
Alles staat in **[Docs/](Docs/README.md)**. Begin bij
|
|
**[Docs/CONTINUE_HERE.md](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](Docs/CONTINUE_HERE.md) |
|
|
| Wat umbrelOS van een app store verwacht | [Docs/Referenties/Umbrel-appstore-spec.md](Docs/Referenties/Umbrel-appstore-spec.md) |
|
|
| Hoe Electrum Gate vandaag in elkaar zit | [Docs/Referenties/Architectuur-huidig.md](Docs/Referenties/Architectuur-huidig.md) |
|
|
| Welke wallets hierheen kunnen wijzen, en wanneer Tor beter is | [Docs/Referenties/Clients.md](Docs/Referenties/Clients.md) |
|
|
| Wat er over de sync-server van Trezor bekend is | [Docs/Referenties/Upstream-evolu-relay.md](Docs/Referenties/Upstream-evolu-relay.md) |
|
|
| Versiegeschiedenis van Electrum Gate | [Docs/CHANGELOG-electrum-gate.md](Docs/CHANGELOG-electrum-gate.md) |
|
|
| Waar documentatie hoort | [Docs/README.md](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.
|