UmbrelApps/Docs/Plannen/Actief/004-Eigenimage/TAKEN.md

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 §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 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

Opgepakt op 07-09-2026 op verzoek van de gebruiker. Fase 1 tot en met 3 zijn in één sessie gedaan en gecommit als Electrum Gate 0.1.0, ongebouwd. Wat nu volgt is van de gebruiker en kan alleen op de Umbrel, want daar staat Docker:

1. sh tools/electrum-gate/build.sh, dan docker login en docker push zoals het script afdrukt;
2. de digest uit de push-uitvoer achter de tag in de compose, twee keer (agent en server);
3. committen en pushen, dan de app in umbrelOS updaten;
4. de vijf controles van fase 4 hieronder.

Dit is de eerste keer dat deze image gebouwd wordt, dus reken op minstens één ronde: een apk add die anders uitpakt dan gedacht, of een pad dat de Dockerfile wél kent en de container niet. De tests hierboven toetsen de tekst van het recept, niet het resultaat.

• Fase 1 tot en met 3 gedaan (07-09-2026), als 0.1.0. De vier *.template-bestanden staan nu in tools/electrum-gate/ zonder de extensie, plus Dockerfile, build.sh en entrypoint.sh. De compose gebruikt één image voor beide containers, ongepind tot de eerste push. Tests aangepast en mutatie-getest; details in PROGRESS.md

• Fase 4: bouwen, duwen, pinnen, installeren, nakijken. Van de gebruiker; zie hierboven

• 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

Fase 1 - Het bouwrecept

• Beslissen: één image of twee (open punt 2). Eén, zoals PLAN.md §6 voorstelt; beslist 07-09-2026, zie OPEN.md
• Beslissen: waar wordt gebouwd (open punt 3). Op de Umbrel, want dat is de enige machine met Docker; de werkplek heeft het niet. Zie OPEN.md
• tools/electrum-gate/Dockerfile: nginx:1.30-alpine plus python3 uit apk, de vijf bestanden erin, ENTRYPOINT [] zodat het envsubst-script van de nginx-image niet meedraait. De bouwcontext is de repo-root, want icon.png blijft in de app-map (het manifest wijst ernaar) en wordt van daar gekopieerd; .dockerignore in de root houdt de context klein
• tools/electrum-gate/build.sh naar het voorbeeld van Evolu Relay: VERSION, controles vooraf (ontbrekende bestanden, een ${ die niemand meer invult), bouwen, en de vervolgstappen afdrukken
• Multi-arch bouwen, en dat is nieuw werk. build.sh heeft er een schakelaar voor: PLATFORMS="linux/amd64,linux/arm64" bouwt met buildx en duwt meteen. Nog nooit geprobeerd, en niet nodig voor eigen gebruik op een amd64-Umbrel. Hoort bij Publicatie-Gate; zie 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 drukt build.sh af. Eigenaar: gebruiker, bij fase 4

Fase 2 - Het command-blok wordt een script

• tools/electrum-gate/entrypoint.sh, uit het command-blok van de compose. Zelfde gedrag, geen $$ meer, en het log_format staat nu gewoon in stream.conf in plaats van in een los bestand dat het script wegschreef. Nieuw erin: het invullen van het backend-adres in het stream-blok (zie fase 3)
• Wat niet mocht sneuvelen en er staat: de sessieteller uit /proc/net/tcp, de herlaadlus met zijn vangnettak, en exec nginx als laatste regel. Alle drie met een toets in test_server_start_zonder_certificaat.py, en die zijn gezien te falen

Fase 3 - De app-map opschonen

• De vier templates uit de app-map, met git mv naar tools/electrum-gate/ zonder .template
• index.html heeft geen template-invulling meer. ${APP_VERSION} en het backend-adres komen uit status.json: de agent krijgt GATE_APP_VERSION: ${APP_VERSION} uit de compose en zet version in de status; het adres stond er al als backend.address
• stream.conf heeft geen template-invulling meer. Twee plaatshouders zonder dollarteken, __GATE_ELECTRUM_HOST__ en __GATE_ELECTRUM_PORT__, die entrypoint.sh uit de omgeving invult; de server-service krijgt daarvoor dezelfde twee variabelen als de agent
• De compose houdt zijn environment-blok; de mounts van de vijf losse bestanden zijn eruit
• Wat er in de app-map overblijft: docker-compose.yml, umbrel-app.yml, icon.png en data/ met zijn twee .gitkeep-bestanden. Precies wat PLAN.md §6 zei
• De tests mee verhuisd: test_agent_certificates.py laadt tools/electrum-gate/agent.py; test_server_start_zonder_certificaat.py toetst entrypoint.sh en de Dockerfile in plaats van het command-blok, plus dat de tag in de compose VERSION uit build.sh is; test_appstore_vorm.py leest ook de nginx-config onder tools/ en toetst tag gelijk aan VERSION voor élke eigen image; test_paginas_parsen.mjs en tools/voorbeeldpagina.mjs vinden een pagina op beide plekken

Fase 4 - Uitrollen en verifiëren

• Image gepind als repo:tag@sha256:<digest> in de compose (twee keer), en version verhoogd in het manifest. Dat laatste staat al op 0.1.0
• Op de Umbrel installeren en controleren dat alles het nog doet: de pagina, de certificaatkeuze, de TLS-poort, de zelfcontrole en het activiteitenlog
• De versie in de kop van de pagina, want die loopt nu via status.json en niet meer via umbreld
• icon.png is hiermee updatebaar, want die zit in de image. Dat was de enige echte uitzondering op "alles komt al aan bij een update"; zie PLAN.md §1

Daarna - Evolu Relay

• Hetzelfde voor de agent en de pagina van Evolu Relay, die nog als *.template op python:3-alpine en nginx:alpine draaien; zie PLAN.md §8. Pas na fase 4 hierboven: eerst zien dat de weg werkt voordat de tweede app hem gaat

Geblokkeerd / wacht op

Fase 4 wacht op de gebruiker: bouwen kan alleen op de Umbrel.