Kort samengevat: de app was in orde—Docker probeerde zijn CLI-configuratie naar de alleen-lezen root van ZimaOS te schrijven
De Compose-stack werkte al op een andere machine. Op ZimaOS mislukte deze met mkdir /root/.docker: read-only file system. Door DOCKER_CONFIG naar een beschrijfbare locatie te verwijzen, werd het werkelijke probleem opgelost.
Gebruik voor een eenmalige app een beschrijfbaar Docker-configuratiepad
sudo -i
mkdir -p /var/lib/docker/.docker
export DOCKER_CONFIG=/var/lib/docker/.docker
docker compose up -dDe opdracht werkte in de praktijk omdat Docker niet langer probeerde /root/.docker aan te maken op het rootbestandssysteem van het apparaat. Docker documenteert de omgevingsvariabele DOCKER_CONFIG in de Docker CLI-configuratie.
Verpak het Compose-bestand correct voor een herhaalbare ZimaOS-app
Het huidige ZimaOS gebruikt normale Docker Compose voor runtime-instellingen en een blok x-casaos op hoofdniveau voor metagegevens van de appstore. De appmetagegevens van ZimaOS definiëren de huidige v2-velden.
Het upstream Docker Compose-schema blijft de bron van waarheid voor de runtime.
Waarom de interface de lokaal geüploade image niet kon gebruiken
De installatieprocedure van de appstore verwacht een imagereferentie die via de appdefinitie kan worden opgelost. Een handmatig geladen lokale image kan wel in Docker bestaan, maar toch niet voldoen aan het installatiepad van de store. Voor een privé-app in huis is directe Compose eenvoudiger; voor distributie publiceer je de image naar een register of bouw je een correct ZimaOS-apppakket.
Houd applicatiegegevens op beschrijfbare opslag
Koppel databases, uploads en configuratie aan persistente hostpaden. De Portainer-vereisten zijn een alternatief voor handmatig beheerde Docker-workloads.
Gebruik het store-protocol alleen wanneer je storefunctionaliteit nodig hebt
Als het doel één boodschappenlijst-app voor het gezin is, volstaat directe Compose. Als het doel distributie via een installeerbare catalogus met pictogrammen, metagegevens en updates is, gebruik je de huidige v2-appstorestructuur van ZimaOS. De appvereisten van ZimaOS bieden de context voor de implementatie.
