Wenn CasaOS selbst geladen wird, der Apps-Bereich nach einem Docker-Update jedoch nur „Apps konnten nicht geladen werden, bitte später aktualisieren“ anzeigt, prüfen Sie die Protokolle von CasaOS App Management, bevor Sie die Dateisystemberechtigungen ändern. Im Fall der IceWhale-Community vom November 2025 war der entscheidende Fehler nicht das Dashboard selbst: CasaOS App Management versuchte, die Docker-API 1.43 zu verwenden, während Docker Engine 29.0.1 mindestens die API 1.44 erforderte.
Dasselbe Protokoll enthielt auch Berechtigungsfehler unter /var/run/casaos, /var/log/casaosund /var/lib/casaos, aber die Ablehnung der Docker-API war ein separates Kompatibilitätsproblem, das CasaOS daran hinderte, Container- und App-Informationen aufzulisten. Die CasaOS-Wartungsteams aktualisierten später das Installationsskript, damit es mit neueren Docker-Versionen funktioniert und die API-Kompatibilität handhabt. Daher sollten aktuelle Benutzer mit dem aktualisierten CasaOS-Installer beginnen, anstatt Docker dauerhaft herunterzustufen.
Der Fehler, der das eigentliche Kompatibilitätsproblem identifizierte
Der ursprüngliche Autor berichtete:
Fehlerantwort des Daemons:
Die Clientversion 1.43 ist zu alt.
Die unterstützte Mindestversion der API ist 1.44.
Bitte aktualisieren Sie Ihren Client auf eine neuere Version.Die Umgebung war:
- Ubuntu Server;
- Docker Engine 29.0.1;
- Docker-API 1.52;
- CasaOS App Management, erstellt im Oktober 2024.
Das erklärt, warum sich das CasaOS-Dashboard weiterhin öffnen ließ, während der Apps-Bereich ausfiel: Die Weboberfläche und der Docker-gestützte Dienst zur App-Verwaltung sind unterschiedliche Ebenen.
Warum ein Docker-Update die CasaOS-App-Liste beschädigen konnte
Die Docker Engine stellt eine versionierte API bereit. Ältere Verwaltungsclients können sich normalerweise mit neueren Daemons abstimmen, aber Docker hat die von ihm akzeptierte Mindestversion schrittweise angehoben.
Die aktuelle Docker-Dokumentation erklärt die Aushandlung von API-Versionen und weist darauf hin, dass ältere API-Versionen schrittweise als veraltet markiert oder entfernt werden. Siehe die Dokumentation zur Docker-Engine-API.
In diesem Fall sprach CasaOS App Management die API 1.43 an, während der Docker-29-Daemon alles unter 1.44 ablehnte. Dadurch schlug die Auflistung der Apps fehl, bevor die Benutzeroberfläche die App-Liste darstellen konnte.
Die Berechtigungsfehler waren real, aber nicht dieselbe Fehlerursache
Die Protokolle enthielten außerdem Meldungen wie:
open /var/run/casaos/app-management.url: Zugriff verweigert
mkdir /var/lib/casaos/appstore/...tmp: Zugriff verweigert
Protokolldatei kann nicht umbenannt werden … Zugriff verweigertDer Autor hatte die Berechtigungen für die relevanten CasaOS-Verzeichnisse bereits erstellt und angepasst, doch der App Store funktionierte weiterhin nicht. Dieses Ergebnis ist wichtig: Umfassende Berechtigungsänderungen konnten eine Inkompatibilität mit der Docker-API nicht beheben.
Nicht rekursiv chmod 777 oder den Besitz von CasaOS-Systemverzeichnissen ändern, nur weil die Benutzeroberfläche meldet, dass Apps nicht geladen werden konnten. Lesen Sie zuerst die genauen Protokolle.
Was die Community damals empfahl
MjTech antwortete, dass dies ein bekanntes Docker-bezogenes Problem sei, und verwies den Autor auf eine von der BigBear-Community bereitgestellte Lösung für Docker-API-Fehler in CasaOS.
Zu diesem Zeitpunkt gehörten zu den gängigen vorübergehenden Workarounds:
- die vom Daemon akzeptierte Mindestversion der Docker-API über einen systemd-Override herabzusetzen;
- oder vorübergehend eine ältere Docker-Version zu verwenden, die die CasaOS-Client-API noch akzeptierte.
Diese Workarounds waren im November 2025 hilfreich, sollten aber nicht automatisch zum dauerhaften Verfahren für 2026 werden, da das CasaOS-Installationsprogramm anschließend aktualisiert wurde.
CasaOS aktualisierte später das Installationsprogramm
Im Dezember 2025 berichtete ein CasaOS-Maintainer auf GitHub, dass das Installationsskript so korrigiert worden sei, dass es:
- die aktuellste verfügbare Docker Engine statt des alten Ziels Docker 24.0.7 zu installieren;
- die Docker-API-Kompatibilität für neuere Docker-Versionen zu handhaben;
- CasaOS-Dienste und integrierte Anwendungen mit modernem Docker funktionieren zu lassen.
Der Maintainer erklärte ausdrücklich, dass eine Neuinstallation oder das aktuelle Installationsskript verwendet werden könne, um das frühere Problem zu beheben, dass Docker-Apps nicht geladen wurden.
Den aktuellen Quelltext findest du im CasaOS-Installationsskript.
Aktuelle erste Maßnahme: Verwende das aktualisierte CasaOS-Installationsprogramm
CasaOS dokumentiert derzeit:
curl -fsSL https://get.casaos.io | sudo bashoder:
wget -qO- https://get.casaos.io | sudo bashBevor du ein Installationsprogramm auf einem bestehenden Server ausführst, sichere wichtige Anwendungsdatenbanken und Konfigurationen. Die Reparatur soll den CasaOS-Zustand bewahren, aber ein Heimserver sollte sich niemals ausschließlich auf ein Reparaturskript als Wiederherstellungsplan verlassen.
Die aktuellen Installationsanweisungen findest du im CasaOS-GitHub-Repository.
Überprüfe den API-Fehler, bevor du einen Kompatibilitäts-Override anwendest
Überprüfe Docker:
docker versionÜberprüfe anschließend die CasaOS-App-Verwaltung:
sudo systemctl status casaos-app-management
sudo journalctl -u casaos-app-management --no-pager -n 100Wenn das Protokoll ausdrücklich Folgendes enthält:
Die Client-Version 1.43 ist zu alt.
Die mindestens unterstützte API-Version ist 1.44.Dann handelt es sich um dieselbe Klasse von Docker-API-Fehlern wie im Ausgangsthread.
Wenn das Protokoll stattdessen Fehler wegen einer vollen Festplatte, DNS-Fehler, einen nicht laufenden Docker-Daemon, einen beschädigten App-Store-Katalog oder fehlende Dateien zeigt, wende keinen API-Workaround nur deshalb an, weil die UI-Meldung identisch ist.
Über den historischen Override für die Docker-API-Kompatibilität
Community- und GitHub-Workarounds während des Vorfalls von 2025 fügten eine systemd-Umgebungseinstellung für Docker hinzu, die ältere Client-API-Versionen wieder zuließ. Dadurch konnte die App-Auflistung wiederhergestellt werden, während CasaOS weiterhin API 1.43 verwendete.
Dadurch wird die Kompatibilitätsgrenze des Docker-Daemons verändert. Betrachten Sie dies als vorübergehenden Kompatibilitätsmechanismus für eine bestätigte Inkompatibilität zwischen altem Client und neuem Daemon, nicht als allgemeine CasaOS-Einstellung zur Leistungsoptimierung.
Die aktuelle Docker-Dokumentation erklärt, dass sich die Unterstützung älterer APIs im Laufe der Zeit ändert, und empfiehlt, die Clients aktuell zu halten, statt dauerhaft auf alte API-Versionen angewiesen zu sein.
DOCKER_API_VERSION in CasaOS nicht blind festlegen
Die Variable „DOCKER_API_VERSION“ von Docker DOCKER_API_VERSION Die Variable zwingt einen Client, eine bestimmte API-Version zu verwenden, und deaktiviert die normale API-Aushandlung. Docker dokumentiert sie hauptsächlich für Fälle, in denen eine exakt bestimmte API-Version erforderlich ist, oder zur Fehlersuche.
Das unterscheidet sich davon, einen neueren Docker-Daemon dazu zu bringen, die API eines älteren CasaOS-Clients zu akzeptieren. Das Festlegen eines beliebigen clientseitigen API-Werts kann die Inkompatibilität verschärfen.
Docker-Zustand ebenfalls überprüfen
sudo systemctl status docker
docker psWenn Docker selbst gestoppt ist, kann CasaOS laufende Container unabhängig von der API-Version nicht auflisten.
Freien Speicherplatz prüfen, bevor Sie etwas neu installieren
Dieselbe UI-Meldung „Failed to load apps“ ist in unabhängigen CasaOS-Fällen aufgetreten, in denen die Systemfestplatte nahezu voll war. Prüfen Sie:
df -hEin vollständig belegtes Root-Dateisystem kann Protokolle, temporäre Dateien, App-Store-Updates und den Docker-Status beeinträchtigen. Gehen Sie nicht davon aus, dass jede identische UI-Meldung dieselbe Ursache hat.
Sichere Reihenfolge zur Fehlerbehebung
- Bestätigen Sie, dass sich das CasaOS-Dashboard selbst öffnen lässt.
- Prüfen
systemctl status dockerunddocker ps. - Prüfen
df -h. - Lesen
casaos-app-managementProtokolle. - Wenn das Protokoll die API-Inkompatibilität 1.43/1.44 zeigt, verwenden Sie zuerst den aktuellen CasaOS-Installations-/Reparaturpfad.
- Verwenden Sie eine Überschreibung zur API-Kompatibilität nur, wenn die Inkompatibilität bestätigt ist und der aktuelle Reparaturpfad nicht verfügbar ist.
- Lockern Sie die Berechtigungen für CasaOS-Verzeichnisse nicht pauschal, wenn dafür keine Belege vorliegen.
- Sichern Sie die App-Daten, bevor Sie eine Neuinstallation durchführen oder systemweite Änderungen an Docker vornehmen.
CasaOS-FAQ: Apps konnten nicht geladen werden
Warum funktioniert das CasaOS-Dashboard, während die Apps nicht funktionieren?
Die Benutzeroberfläche, die CasaOS-Dienste, der Docker-Daemon und CasaOS App Management sind separate Komponenten. Im beschriebenen Fall trat der Fehler konkret auf, als App Management Docker abfragen wollte.
War Docker 29 im ursprünglichen Thread die Ursache?
Die Quellprotokolle zeigten, dass Docker 29.0.1 die API 1.44 erforderte, während der installierte CasaOS-App-Management-Client die API 1.43 verwendete. Diese Inkompatibilität verhinderte direkt die Auflistung der Apps.
Sollte ich die Berechtigungen von CasaOS-Ordnern mit chmod ändern, um die Seite zu reparieren?
Nicht ohne Belege. Der ursprüngliche Autor hatte die Berechtigungen bereits angepasst, und der Docker-API-Fehler trat weiterhin auf. Lesen Sie zuerst die genauen Dienstprotokolle.
Sollte ich Docker downgraden?
Das war eine frühere Behelfslösung. CasaOS hat sein Installationsprogramm später aktualisiert, um moderne Docker-Versionen zu unterstützen. Verwenden Sie daher den aktuellen Reparatur-/Installationspfad, bevor Sie eine ältere Docker-Version erzwingen.
Bedeutet „Failed to load apps“ immer eine Inkompatibilität der Docker-API?
Nein. Dieselbe UI-Meldung kann durch einen gestoppten Docker-Daemon, einen vollen Datenträger, Berechtigungsprobleme, Fehler bei der App-Verwaltung oder andere Dienstprobleme entstehen. Das Protokoll liefert die Diagnose.
