UmbrelApps/Docs/Plannen/Archief/Eigenimage/PROGRESS.md

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.

08-09-2026 (avond) - Relay gebouwd en in gebruik; het plan is af

De gebruiker bouwde en duwde de Relay-image; ook deze slaagde in één keer, ondanks apt en www-data. Digest drie keer in de compose, update gedaan, pagina toont v0.6.0 en een sync werkt. Niet herinstalleerd, want de database moest blijven; de zes achtergebleven programmabestanden zijn met de hand uit de app-datamap gehaald. Daarmee is Eigenimage voor beide apps af en verhuist de map naar Archief/. Gevolg voor de rest: de pin-taak in Umbrelapp is vervallen, Publicatie-Relay wacht niet meer op "een image die te pinnen valt", en het enige dat er nog aan de images ontbreekt voor publicatie is linux/arm64.

08-09-2026 (later) - Evolu Relay: alles in één image, in de repo klaar

Direct erna, op verzoek van de gebruiker en met zijn keuze: één image met de relay erbij, geen tweede recept. De drie templates zijn met git mv naar tools/evolu-relay/ gegaan, naast src/; de Dockerfile blijft op node:24-slim (om better-sqlite3) en haalt nginx en python3 uit apt. Twee dingen die Debian anders doet dan de nginx-image en die je moet kennen: geen gebruiker nginx (dus www-data), en geen USER meer in de image, zodat de compose de relay met user: node laat draaien en de andere twee als root.

De versie in de kop loopt nu via api/status, zoals bij Gate. Versie 0.6.0 in manifest, VERSION en drie keer in de compose, ongepind. Tests: alle zes groen, niets overgeslagen; de vormtest toetst de drie tags tegen VERSION. In de voorbeeldpagina staat v0.6.0 in de kop. Niet geverifieerd: de image, en dit is de eerste met apt erin. Bouwen is aan de gebruiker.

08-09-2026 - gebouwd, gepind, geïnstalleerd: Gate draait op zijn eigen image

De gebruiker bouwde en duwde de image op de Umbrel; de bouw slaagde in één keer, dus de zorg over apk add python3 en de paden in de Dockerfile was ongegrond. Digest sha256:97fee09b…7cfd8f, twee keer in de compose gezet, en de anonieme pull gaf dezelfde digest terug. Daarna geüpdatet, en de gebruiker heeft de app ook gedeïnstalleerd en opnieuw geïnstalleerd zodat de oude templates uit de app-datamap zijn. De pagina toont v0.1.0, dus de weg via status.json werkt. Voor Electrum Gate is dit plan af; bij die app is niets meer over van python:3-alpine en nginx:alpine. Volgende stap is Evolu Relay, §8.

07-09-2026 - fase 1 tot en met 3 in één sessie: het recept staat, de app-map is leeg

Op verzoek van de gebruiker opgepakt, direct na Relay 0.5.6. De vier templates zijn met git mv naar tools/electrum-gate/ verhuisd en heten daar gewoon agent.py, nginx.conf, stream.conf en index.html. Daarnaast nieuw: Dockerfile (nginx:1.30-alpine plus python3), entrypoint.sh (het command-blok van de compose, zonder $$) en build.sh naar het voorbeeld van Evolu Relay. Open punt 2 en 3 zijn beslist: één image, gebouwd op de Umbrel.

Wat er inhoudelijk veranderde en niet alleen verhuisde: het log_format staat nu in stream.conf zelf, het backend-adres komt via twee plaatshouders zonder dollarteken uit de omgeving (ook de server-service krijgt ze nu), en de pagina haalt versie en adres uit status.json, waarvoor de agent GATE_APP_VERSION doorgeeft. De compose is voor het eerst sinds 0.0.3 zonder shellblok.

Tests: alle zes groen, niets overgeslagen. Drie mutaties (het exec voor nginx weg, ENTRYPOINT [] weg, één tag in de compose verhoogd) lieten precies de bedoelde toetsen omvallen, ook de nieuwe in test_appstore_vorm.py. Niet geverifieerd: de image zelf. Er is hier geen Docker, dus of apk add python3 het gedraagt zoals gedacht en of de container start, blijkt pas bij fase 4 op de Umbrel. Electrum Gate staat op 0.1.0 in het manifest, met de tag ongepind tot de eerste push.

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: 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 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.