Deze bron bevat meerdere storingen die kort na elkaar zijn opgetreden en mag daarom niet worden herschreven als één eenvoudige ‘Portainer-bug’. De systeemschijf had vrijwel geen vrije ruimte meer, Docker en containerd werden via Debian bijgewerkt naar belangrijke nieuwe versies, een oudere Docker CLI-test werd door de Docker 29-daemon afgewezen, Portainer raakte zijn Local-omgeving kwijt, CasaOS bleef ‘apps laden’ weergeven en een later opstartprobleem liet het dashboard er bijna uitzien als een nieuwe installatie.
Geen enkel antwoord in de bron bevestigt één uiteindelijke hoofdoorzaak. De veiligste interpretatie is een gelaagd herstelprobleem: maak eerst een back-up van de bestaande gegevens en bepaal vervolgens welk opstart-/rootbestandssysteem actief is, of de Docker-dataroot nog bestaat, of de daemon gezond is en of Portainer/CasaOS compatibel zijn met de bijgewerkte Docker-API.
Er was al sprake van ernstige ruimtegebrek op de systeemschijf
De gebruiker had vóór het opruimen nog slechts ongeveer 1 GB vrij op een rootbestandssysteem van 27 GB. Grote ruimtevreters waren onder andere Docker-overlaygegevens, Jellyfin-metadata, systeemlogboeken en ontwikkelpakketten.
Weinig vrije ruimte kan ertoe leiden dat Docker-image- en containerbewerkingen, databases, logboeken en CasaOS-services zich onvoorspelbaar gedragen. Ruimte vrijmaken was hoe dan ook noodzakelijk, los van het latere Docker-API-probleem.
De hostupgrade veranderde Docker van 28.x naar 29.0.0
De pakketgeschiedenis van Debian liet updates zien van:
-
docker-ce; -
docker-ce-cli; -
containerd.io; - extra rootless Docker-pakketten.
Een grote upgrade van Docker Engine kan compatibiliteitsproblemen aan het licht brengen in beheertools die oudere API-clients meeleveren of ermee onderhandelen.
De bron legde een echte mismatch in Docker-API-versies vast
Een Docker 24.0.5 CLI-container gaf het volgende terug:
client version 1.43 is too old.
Minimum supported API version is 1.44Die melding vormt direct bewijs dat ten minste één oude client niet langer met de bijgewerkte Docker-daemon kon communiceren. Op zichzelf bewijst dit niet dat Portainer exact die clientversie gebruikte, maar het maakt API-compatibiliteit tot een controlepunt met hoge prioriteit.
Dat Portainer Local eerst als actief toonde en daarna ontbrak, wijst op een symptoom in de beheerlaag
In de bron werd geprobeerd een lokale Docker-omgeving opnieuw aan te maken via /var/run/docker.sock, maar zonder succes. Controleer het volgende voordat je de Portainer-status verwijdert:
docker info
docker ps
ls -l /var/run/docker.sockAls de Docker CLI zelf werkt maar Portainer niet, richt je dan op de Portainer-versie, API-compatibiliteit en toegang tot de socket. Als Docker zelf niet werkt, moet eerst de daemon worden hersteld.
CasaOS dat ‘apps laden’ toont, suggereert dat de storing breder was dan alleen Portainer
Ook CasaOS had moeite om applicaties weer te geven. Dat kan gebeuren wanneer Docker niet beschikbaar is, de Docker-API incompatibel is gewijzigd, de dataroot van de daemon ontbreekt of de opgestarte host niet langer de verwachte systeemtoestand heeft.
De latere melding ‘Select Proper Boot Device’ verandert de herstelprioriteit
Na een herstart startte de machine niet normaal op totdat de gebruiker de opstartselectie wijzigde. Toen het systeem weer werkte, had CasaOS geen apps meer, hoewel de grote HDD nog gekoppeld was.
Dat maakt het mogelijk dat een andere opstartschijf of een ander rootbestandssysteem was geselecteerd, of dat de systeempartitie/-status was gewijzigd. De bron bewijst niet welke van deze mogelijkheden van toepassing is.
Maak een back-up van AppData voordat je CasaOS opnieuw installeert
Voor de gebruiker waren vooral de volgende gegevens belangrijk:
-
/home/casaos-projectbestanden; - Jellyfin-metadata onder AppData;
- mediabestanden op de HDD;
- Docker-/CasaOS-configuratie, voor zover die kan worden hersteld.
Kopieer deze duurzame mappen naar een andere schijf of een ander systeem voordat je Docker opnieuw installeert of reset. Containers opnieuw aanmaken is doorgaans eenvoudiger dan applicatiedatabases en metadata opnieuw opbouwen.
Voer geen agressieve Docker-pruning uit voordat je weet waarnaar nog wordt verwezen
Het opschonen van images kan ruimte vrijmaken, maar het verwijderen van volumes of datarootmappen kan de applicatiestatus verwijderen die je juist probeert te redden. Breng eerst containers, volumes, bind mounts en AppData-paden in kaart.
Beschouw Debian- en Docker-updates als onderdeel van het CasaOS-platform
CasaOS draait boven op de onderliggende Linux-host. Een brede apt upgrade kan Docker, de kernel, systemd, netwerkpakketten en opslagpakketten bijwerken waarvan CasaOS afhankelijk is. Test grote hostupgrades bewust en zorg voor een back-up van het systeem en de applicaties voordat je ze uitvoert op een werkende NAS.
Veelgestelde vragen over herstel van Portainer/CasaOS
Bewijst de bron dat Docker 29 alleen alle storingen heeft veroorzaakt?
Nee. Het systeem was ook bijna vol en kreeg later te maken met een probleem met het opstartapparaat of de systeemstatus.
Was er een bevestigde mismatch in Docker-API-versies?
Ja. Een Docker 24-CLI die API 1.43 gebruikte, werd afgewezen omdat de Docker 29-daemon minimaal versie 1.44 vereiste.
Moet de gebruiker CasaOS opnieuw installeren voordat AppData wordt gekopieerd?
Nee. Maak eerst een back-up van belangrijke AppData, bestanden in de home-directory en mediabestanden, zolang de schijven toegankelijk blijven.
