De leeskant is bewezen, en daarmee is het doel van Umbrelapp gehaald

Getest met een tweede gebruikersaccount op dezelfde Mac, en dat is schoner dan een
tweede apparaat: die installatie begint met een lege lokale Evolu-database, dus
alles wat daar verschijnt kan alleen van de relay komen. De labels kwamen door, en
een wijziging aan die kant komt ook weer terug. Beide richtingen dus, met bewijs.

Daarmee staat er wat dit plan beloofde: een tweede app in deze store,
geinstalleerd op de Umbrel, met Trezor Suite die erop synchroniseert. Het restwerk
is klein en wacht nergens op: een herstart van de app overleven, twee images
pinnen, en data per eigenaar kunnen wissen.

Prioriteitsherziening die daarbij hoort. Umbrelapp zakt van A naar B. Eigenimage
gaat naar A, want dat lag alleen stil omdat de gebruiker eerst Evolu Relay wilde
afmaken; het is hernummerd naar 004 zodat de bovenkant van de reeks weer op
tier-orde staat. Proefopstelling zakt naar B en is klaar voor het archief: alle
vragen die het bezat zijn hier beantwoord, en de rest gaat over een pakket dat niet
meer bestaat.

De takenlijst is opgeschoond van regels die over het oude pakket gingen: de
Postgres-pin, de schemavraag, het adres op 3851 en de twee blokkades. In plaats
daarvan staan de twee images die nu nog ongepind zijn. En de controle of deze app
Electrum Gate raakt is afgevinkt met wat er werkelijk gebeurde: dat deed hij, via
een gedeelde containernaam, en dat is gerepareerd.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Harmen
2026-08-28 13:59:15 +02:00
co-authored by Claude Opus 5
parent af7857251d
commit e4a8747307
8 changed files with 54 additions and 34 deletions
@@ -0,0 +1,48 @@
# Open punten - Eigenimage
> Beslissingen die nog een **eigenaar** of een **moment** nodig hebben. Staat een punt hier zonder
> allebei, dan is dat de eerste fout om op te lossen. Wordt een punt een taak, dan verhuist het naar
> [TAKEN.md](TAKEN.md).
>
> **Nummers blijven staan**, ook als een punt beslist is: er kan elders naar verwezen worden, ook vanuit
> codecommentaar. Beslissen betekent verplaatsen naar de kop hieronder, niet hernummeren.
>
> Deze drie punten stonden als §7 in het masterplan en zijn bij de promotie op 27-08-2026 hierheen
> verhuisd.
## Nog te beslissen
2. **Eén image of twee?** [PLAN.md](PLAN.md) §6 stelt één voor: de agent en nginx blijven twee containers,
maar ze delen één image. Twee images is netter gescheiden en verdubbelt het bouwwerk en het pinwerk.
**Moment:** bij de start van het werk · **Eigenaar:** sessie, met de gebruiker mee
3. **Waar wordt gebouwd?** Op de Umbrel staat Docker, maar dat is een productiemachine en hij is amd64,
terwijl arm64 ook een eis is. Bouwen op de werkplek van de gebruiker vraagt daar Docker. Dit hangt samen
met de multi-arch-stap uit §4 van het plan, die nog nooit geprobeerd is.
**Moment:** bij de start van het werk · **Eigenaar:** gebruiker
## Beslist
1. **Blijft het Gitea-register ook bij publicatie de bron?** - **Voor nu Gitea, bij inlevering opnieuw
kijken** (27-08-2026, gebruiker).
De twee bezwaren die dit punt opriep gelden allebei pas bij inlevering, en dat is niet aan de orde: "dit
is echt mijn eigen app voor eigen gebruik, ik ben nog niet toe aan publiceren." Het domein van de
gebruiker staat dan in een pakket dat niemand aangeboden krijgt, en de enige die een image van zijn
thuisserver haalt is hij zelf. Daarmee vervallen ze niet, ze zijn alleen nog niet actueel.
**Wat dat voor dit plan betekent:** `build.sh` duwt naar `sc.kamenier-hamer.nl/sysop/...`, net als bij
Evolu Relay, en de compose pint op een digest daaruit. Het bouwrecept hoeft er niet omheen ontworpen te
worden dat het register later kan wisselen; een register wisselen is één regel in `build.sh` en één in
de compose, plus een versieverhoging.
**Wat er wél voor terugkomt is een taak in Publicatie-Gate en niet hier.** Bij inlevering moet het
register opnieuw beoordeeld worden, samen met het kaal maken van het app-id en het pinnen; dat zijn
toch al drie dingen die een herinstallatie vragen en die je één keer wilt doen. De gebruiker noemde er
nog iets bij dat de moeite van het uitzoeken waard is voordat het zover is: **umbrelOS zou een eigen
register toestaan.** Dat is niet nagetrokken, en het is precies het soort aanname dat je niet wilt
ontdekken op het moment van inleveren.
De spec zoals we hem kennen eist alleen `registry/repo:versie-of-commit@sha256:<digest>` met beide
architecturen erin, en zegt niets over wélk register. Naar de letter mag Gitea dus ook dan.
**Moment:** afgerond voor dit plan; het vervolg hoort bij **Publicatie-Gate** · **Eigenaar:**
+163
View File
@@ -0,0 +1,163 @@
# Eigenimage - plan
> **App: Electrum Gate**, met een korte paragraaf over wat het voor Evolu Relay betekent (§8). Voorgesteld
> door de gebruiker op 27-08-2026: van de uitvoerbare bestanden die nu in de app-map staan een image maken
> en die in het eigen Gitea-register zetten.
>
> **Gepromoveerd van masterplan naar `Actief/` op 27-08-2026**, toen **Webinterface** afgerond was; dat was
> de volgorde die de gebruiker die dag afsprak. Het origineel staat in `Plannen/Masterplannen/Archief/` en
> is historie: hier wordt gewerkt.
>
> Taken staan in [TAKEN.md](TAKEN.md), de open beslissingen in [OPEN.md](OPEN.md). §7 en §9 hieronder zijn
> daarheen verhuisd en staan er niet meer; wat hier blijft is het ontwerp en de afweging.
## 1. Waar dit over gaat, en wat het uitdrukkelijk níet oplost
Electrum Gate is de enige app in deze store zonder eigen image. Hij draait op `python:3-alpine` en
`nginx:alpine` en mount zijn eigen programmacode uit `app-data`. Dat is geen ongeluk maar een besluit uit
het plan **Appstore**: geen eigen image bouwen betekende toen geen bouwstap, geen register en geen
inloggegevens, en de app werkte.
Dit plan stelt dat besluit ter discussie, en het begint met wat het **niet** is:
**Dit is geen oplossing voor het updateprobleem, want dat is er niet meer.** De valkuil die dit project een
dag gekost heeft is dat een update alleen een whitelist ververst. Maar `*.template` staat in die whitelist,
en alle code van deze app staat inmiddels in een `.template`-bestand: `agent.py.template`,
`index.html.template`, `nginx.conf.template` en `stream.conf.template`. Een `git push` met een
versieverhoging bereikt een bestaande installatie dus gewoon. Wie dit plan verkoopt met "dan komen
wijzigingen eindelijk aan", verkoopt iets wat al werkt.
Er is één uitzondering en die is echt: **`icon.png` is geen template** en bereikt een bestaande installatie
nooit. Dat staat als zodanig in de compose. Voor een plaatje dat vrijwel nooit wijzigt is dat goed genoeg,
en het is te klein om dit plan op te bouwen.
Wat het wél is, staat in §3.
## 2. Wat er vandaag uit `app-data` gemount wordt
De inventaris, want dit is precies de lijst die in een image zou verdwijnen.
| Bestand | Container | Wat het is |
|-|-|-|
| `agent.py` | agent | het programma: certificaten lezen, de Electrum-server bevragen, `status.json` schrijven, de keuze aannemen |
| `nginx.conf` | server | de configuratie van de pagina en de proxy naar de agent |
| `stream.conf` | server | het TLS-blok voor poort 50022, bewust apart |
| `index.html` | server | het dashboard |
| `icon.png` | server | het plaatje in de kop en het tabblad |
| het `command`-blok | server | ruim honderd regels shell in `docker-compose.yml`: log-format, TLS aan- en uitzetten, de sessieteller en de herlaadlus |
Die laatste regel is de interessantste. Dat blok staat in de compose omdat de compose in de whitelist
staat, en het moet daar dollartekens ontsnappen als `$$` omdat umbreld elk `${...}` in een template
leegmaakt. Het is dus shell in een YAML-string met een eigen ontsnappingsregel eroverheen: het enige stuk
van deze app waar de vorm door de verpakking bepaald wordt en niet door wat het doet.
## 3. Wat een eigen image oplevert
Op volgorde van hoe zwaar het weegt.
1. **De programmacode gaat uit `app-data`.** Dat is de afwijking die de gebruiker zelf opmerkte op
20-08-2026, uitgezocht in `Umbrel-appstore-spec.md`: bij andere apps staat in `app-data` alleen
configuratie en data, want hun code zit in een image. Voor eigen gebruik is dat cosmetisch. Voor het
masterplan **Publicatie-Gate** is het meer dan dat, want daar kijkt iemand anders naar het pakket.
2. **Het `command`-blok wordt een gewoon script.** Een `entrypoint.sh` in de image is te lezen, te
controleren en desnoods te testen, en hoeft geen dollartekens te verdubbelen. Dat is de grootste
inhoudelijke winst en de enige die de code zelf beter maakt.
3. **Eén digest in plaats van twee vreemde.** De pin-eis uit **Publicatie-Gate** gaat nu over
`python:3-alpine` en `nginx:alpine`, images van iemand anders die bij elke beveiligingsupdate opnieuw
gepind moeten worden. Met een eigen image pin je één ding dat je zelf uitgeeft. Let op de andere kant
hiervan: de basisimage zit dan ín jouw image, dus het onderhoud verdwijnt niet, het verhuist naar het
bouwrecept.
4. **`icon.png` wordt updatebaar**, zie §1.
## 4. Wat het kost, en dit is de reden dat het moment ertoe doet
**Elke wijziging wordt een bouwronde.** Vandaag is een wijziging aan het dashboard: bestand aanpassen,
`version` ophogen, committen, in umbrelOS updaten. Met een eigen image wordt dat: aanpassen, bouwen, naar
het register duwen, de digest opzoeken, de compose bijwerken, `version` ophogen, committen, updaten. Dat is
geen ramp, maar het is een veelvoud, en het moet op de machine met Docker gebeuren en niet op de machine
waar geschreven wordt.
Dat is precies het probleem met "nu": het plan **Webinterface** staat op tier A en itereert op
`index.html.template`. Een bouwronde per UI-wijziging remt het plan dat op dit moment het meeste oplevert.
**Multi-arch is een tweede kostenpost.** De eis is `linux/amd64` én `linux/arm64` in de manifest-lijst. De
Umbrel van de gebruiker is amd64 (vastgesteld 20-08-2026 uit de nginx-startlog), dus een `docker build`
daar levert de helft. Dat vraagt `buildx` met QEMU, en dat is trager en kan bij een Python-image met
gecompileerde afhankelijkheden stukgaan. Deze app heeft die afhankelijkheden niet, dus de kans is klein,
maar hij is niet nul en het is nog nooit geprobeerd.
## 5. Het register: Gitea werkt, en dat is bewezen
Dit is het deel waar het minste onzeker aan is, want de weg is al een keer gelopen.
Op 25-08-2026 faalde de eerste installatie van Evolu Relay met `pull access denied` op een image die alleen
lokaal gebouwd was. De verklaring staat in `Umbrel-appstore-spec.md`: umbreld haalt elke image zelf op via
de Docker Engine API, dus lokaal bouwen bestaat niet voor hem en `pull_policy: never` verandert daar niets
aan. De oplossing werd het Gitea-register op dezelfde server als de store,
`sc.kamenier-hamer.nl/sysop/evolu-relay`, gepind op tag plus digest.
Twee dingen zijn daarbij al vastgesteld en gelden hier onverkort:
- **anoniem halen moet werken**, want umbreld krijgt geen inloggegevens mee. Controleer dat met een
uitgelogde pull in dezelfde context waarin je inlogde, anders meet je je eigen sessie. Het commando staat
onderaan `tools/evolu-relay/build.sh`;
- **het bouwrecept hoort in `tools/`**, nooit in de app-map. Een `Dockerfile` staat niet in de
update-whitelist, dus bouwen-in-de-app kost bij elke versie een deïnstallatie.
## 6. Hoe het eruit zou zien
Eén image, niet twee. De agent en nginx blijven wel twee containers, want ze doen verschillend werk en de
sessieteller moet in de netwerk-namespace van nginx zitten; maar één image met beide erin scheelt een
bouwrecept, en `nginx` plus `python3` in één alpine is klein.
```
tools/electrum-gate/
Dockerfile de basisimage, agent.py, de nginx-configuratie, de pagina, entrypoint.sh
build.sh pin op de basisimage, bouwt multi-arch, duwt naar het register, drukt de digest af
```
Wat er in de app-map overblijft: `docker-compose.yml`, `umbrel-app.yml`, `icon.png` en `data/` met zijn
twee `.gitkeep`-bestanden. De compose houdt zijn `environment`-blok, want dat is hoe
`${APP_ELECTRS_NODE_IP}` binnenkomt, en die weg is op 27-08-2026 juist bewezen bij de omschakeling naar
Fulcrum.
Eén ding om bij het ontwerp niet over te slaan: `index.html.template` bevat vandaag
`${APP_ELECTRS_NODE_IP}:${APP_ELECTRS_NODE_PORT}`, ingevuld door umbreld bij het starten. Zit de pagina in
de image, dan bestaat die invulling niet meer en moet het adres langs de omgeving naar binnen, bijvoorbeeld
doordat de agent het in `status.json` zet en de pagina het daaruit leest. Dat is werk dat nu nog gratis is
en straks niet meer.
## 7. Open punten
Verhuisd naar [OPEN.md](OPEN.md) bij de promotie op 27-08-2026. Het gaat om drie vragen: blijft het
Gitea-register ook bij publicatie de bron, wordt het één image of twee, en waar wordt er gebouwd. De eerste
moet vóór de eerste taak beantwoord zijn.
Dit kopje blijft staan met deze verwijzing en is niet weggehaald, want de nummering van de paragrafen
hierna wordt elders aangehaald.
## 8. Wat dit voor Evolu Relay betekent
Voor die app is dit plan grotendeels al uitgevoerd: `tools/evolu-relay/build.sh` bestaat, het register is
gekozen en de anonieme pull is gecontroleerd. Wat hier eventueel bijkomt is de multi-arch-stap, want ook
dat recept bouwt vandaag één architectuur.
**Trek dat werk niet in dit plan.** Het plan **Umbrelapp** staat op tier A met de conclusie dat de
gepakketteerde relay in de kern niet kan werken, en dat de volgende stap de kale
`docker.io/evoluhq/relay:latest` is. Wordt dat de weg, dan is er een gepubliceerde image en vervalt het
hele bouwrecept. Iets verbeteren aan een recept dat misschien weggaat, is de verkeerde volgorde.
## 9. Waarom dit nú actief is
**Beslist door de gebruiker op 27-08-2026: na Webinterface**, en dat moment is er. Dat was dezelfde
afweging als waarom de pin-eis in **Publicatie-Gate** op "niet nu doen" staat: zolang er nog gedraaid en
verbeterd wordt, betaalt elke wijziging de bouwronde uit §4 en levert het niets op wat er dan ontbreekt.
**Webinterface** iterereerde die dag juist op de pagina, en dat was het werk dat er het meeste onder zou
lijden. Dat plan is dezelfde dag afgerond en naar tier B gezakt.
Het valt daarmee ook samen met het werk dat toch aan de compose gedaan moet worden vóór de inlevering uit
**Publicatie-Gate**: het pinnen en het kaal maken van het app-id vragen allebei een herinstallatie, en die
kun je één keer doen in plaats van drie keer.
**Wat dit niet is: een harde afhankelijkheid.** Technisch kon dit plan altijd al. De volgorde was een
keuze, geen feit over het plan.
@@ -0,0 +1,36 @@
# Voortgang - Eigenimage
> Chronologisch sessielog, nieuwste bovenaan. Kort: 3 tot 6 regels per entry. Wat er is gebeurd en
> waarom, niet wat er nog moet: dat staat in [TAKEN.md](TAKEN.md).
## 27-08-2026 - het register is beslist, en daarna ging de aandacht naar Evolu Relay
Open punt 1 beantwoord: **voor nu Gitea, bij inlevering opnieuw kijken.** De twee bezwaren die dat punt
opriep, het domein in een publiek pakket en andermans installaties die aan de thuisserver hangen, gelden
allebei pas bij inlevering, en de gebruiker is daar uitdrukkelijk nog niet aan toe: dit is voorlopig zijn
eigen app voor eigen gebruik.
Daarmee is de enige vraag weg die vóór het bouwen beantwoord moest zijn, en kan fase 1 zo beginnen. Wat er
bij het antwoord hoort en niet vergeten mag worden staat in [OPEN.md](OPEN.md): bij inlevering moet het
register opnieuw beoordeeld worden, en de opmerking van de gebruiker dat umbrelOS een eigen register zou
toestaan is niet nagetrokken.
**Het plan ligt daarna meteen stil**, op zijn verzoek: hij gaat eerst verder met Evolu Relay, die getest
moet worden en op dit moment uitstaat. Er is aan dit plan nog niets gebouwd, dus er ligt ook niets half af.
**Geraakt:** alleen documentatie. **Tests:** niet van toepassing.
## 27-08-2026 - gepromoveerd naar Actief, er is nog niets gebouwd
Het masterplan is omgezet naar een plan onder `Actief/` met nummer 006, direct nadat **Webinterface**
afgerond en naar tier B gezakt was. Dat was de volgorde die de gebruiker diezelfde dag afsprak toen het
plan geschreven werd.
Er is aan de app zelf nog **niets** gedaan. Wat hier ligt is ontwerp: de inventaris van wat er vandaag uit
`app-data` gemount wordt, wat een eigen image wel en niet oplevert, en wat het kost. De drie open
beslissingen uit §7 zijn naar [OPEN.md](OPEN.md) verhuisd.
Het eerste wat er moet gebeuren is geen bouwtaak maar open punt 1: blijft het Gitea-register ook bij
publicatie de bron. Dat bepaalt waar het bouwrecept naartoe duwt.
**Geraakt:** alleen documentatie. **Tests:** niet van toepassing.
@@ -0,0 +1,82 @@
# Taken - Eigenimage
> Prioriteit: **A** | Wacht op:
>
> **Gepromoveerd van masterplan naar `Actief/` op 27-08-2026**, direct na het afronden van
> **Webinterface**. Dat was de volgorde die de gebruiker die dag afsprak, en de reden staat in
> [PLAN.md](PLAN.md) §9: een eigen image maakt van elke paginawijziging een bouwronde, en dat had het
> werk aan de webinterface geremd. Dat werk is nu klaar.
>
> **Het register is beslist (27-08-2026): Gitea, net als bij Evolu Relay.** Bij inlevering wordt het
> opnieuw bekeken, en dat is dan een taak van **Publicatie-Gate**. De gebruiker is uitdrukkelijk nog niet
> toe aan publiceren: dit is voorlopig zijn eigen app voor eigen gebruik. Zie [OPEN.md](OPEN.md) punt 1,
> inclusief het ene ding dat daar nog uitgezocht moet worden.
>
> **En lees §1 van het plan.** Het argument dat voor de hand ligt, "dan komen wijzigingen eindelijk aan bij
> een bestaande installatie", geldt hier níet: alle code staat in een `*.template` en die staan in de
> update-whitelist. Wat dit plan wél oplevert, staat in §3.
## Volgende stap
> **Dit plan ligt stil op verzoek van de gebruiker (27-08-2026): hij gaat eerst verder met Evolu Relay,
> zie het plan Umbrelapp.** Dat is een volgordekeuze en geen blokkade; er is aan dit plan nog niets
> gebouwd, dus er ligt ook niets half af. Beginnen kan met fase 1, en het antwoord dat daarvoor nodig was
> staat er.
- [x] **Open punt 1 beantwoord (27-08-2026): voor nu Gitea, bij inlevering opnieuw kijken.** Daarmee is de
enige vraag weg die vóór het bouwen beantwoord moest zijn. Zie [OPEN.md](OPEN.md)
- [ ] **Fase 1 beginnen: het bouwrecept in `tools/electrum-gate/`.** Open punt 2 en 3 horen bij die start
en niet ervoor: één image of twee, en op welke machine er gebouwd wordt. Dat laatste is de enige die
de gebruiker moet beantwoorden, en pas op het moment dat het recept er is en gedraaid moet worden
## Fase 1 - Het bouwrecept
- [ ] Beslissen: één image of twee (open punt 2). [PLAN.md](PLAN.md) §6 stelt één voor
- [ ] Beslissen: waar wordt gebouwd (open punt 3). De Umbrel is amd64 en een productiemachine
- [ ] `tools/electrum-gate/Dockerfile` schrijven: basisimage, `agent.py`, de nginx-configuratie, de pagina,
en een `entrypoint.sh`. **Niet in de app-map**: een `Dockerfile` staat niet in de update-whitelist,
dus bouwen-in-de-app kost bij elke versie een deïnstallatie
- [ ] `tools/electrum-gate/build.sh` naar het voorbeeld van `tools/evolu-relay/build.sh`: pin op de
basisimage, bouwen, naar het register duwen, en de digest afdrukken die in de compose moet
- [ ] **Multi-arch bouwen, en dat is nieuw werk.** `linux/amd64` én `linux/arm64` in de manifest-lijst.
Vraagt `buildx` met QEMU en is hier nog nooit geprobeerd; zie [PLAN.md](PLAN.md) §4
- [ ] **Controleren dat de image anoniem te halen is.** umbreld krijgt geen inloggegevens mee. Uitloggen in
dezelfde context waarin je inlogde, anders meet je je eigen sessie. Het commando staat onderaan
`tools/evolu-relay/build.sh`
## Fase 2 - Het `command`-blok wordt een script
- [ ] Het inline `command`-blok uit `docker-compose.yml` omzetten naar `entrypoint.sh` in de image. Dat is
ruim honderd regels shell in een YAML-string met een eigen ontsnappingsregel voor het dollarteken;
zie [PLAN.md](PLAN.md) §2. **Dit is de grootste inhoudelijke winst van het hele plan**
- [ ] Let op wat daarbij niet mag sneuvelen: het `log_format` met `$$`, de sessieteller uit
`/proc/net/tcp`, de herlaadlus met zijn vangnettak, en het feit dat nginx met `exec` het hoofdproces
wordt. Die laatste is geen detail: andersom blijft de shell PID 1, geeft signalen niet door, en ziet
Docker een geslaagde afsluiting als nginx omvalt
## Fase 3 - De app-map opschonen
- [ ] `agent.py.template`, `nginx.conf.template`, `stream.conf.template` en `index.html.template` uit de
app-map halen zodra ze in de image zitten
- [ ] **`index.html` heeft dan geen template-invulling meer.** Vandaag staat er
`${APP_ELECTRS_NODE_IP}:${APP_ELECTRS_NODE_PORT}` in, ingevuld door umbreld bij het starten. Zit de
pagina in de image, dan moet dat adres langs de omgeving naar binnen, bijvoorbeeld doordat de agent
het in `status.json` zet en de pagina het daaruit leest. Dat is werk dat nu nog gratis is
- [ ] De compose houdt zijn `environment`-blok; dat is hoe `${APP_ELECTRS_NODE_IP}` binnenkomt, en die weg
is op 27-08-2026 bewezen bij de omschakeling naar Fulcrum
- [ ] Wat er in de app-map overblijft: `docker-compose.yml`, `umbrel-app.yml`, `icon.png` en `data/` met
zijn twee `.gitkeep`-bestanden
## Fase 4 - Uitrollen en verifiëren
- [ ] Image gepind als `repo:tag@sha256:<digest>` in de compose, en `version` verhoogd in het manifest.
Zonder die verhoging rolt umbrelOS niets uit
- [ ] Op de Umbrel installeren en controleren dat alles het nog doet: de pagina, de certificaatkeuze, de
TLS-poort, de zelfcontrole en het activiteitenlog
- [ ] **`icon.png` wordt hiermee updatebaar**, want die zit dan in de image. Dat was de enige echte
uitzondering op "alles komt al aan bij een update"; zie [PLAN.md](PLAN.md) §1
## Geblokkeerd / wacht op
Niets, behalve open punt 1 hierboven, en dat is een vraag van één regel aan de gebruiker.