[Feedback]error
"Failure to load apps. Please refresh later casaos"
The root cause, as seen in the system logs, is a version mismatch between the CasaOS App Management client and a modern Docker Engine (e.g., v23.0.0+):
Error response from daemon: client version 1.42 is too old. Minimum supported API version is 1.44, please upgrade your client to a newer version
Even if your Docker Engine is up-to-date (e.g., API v1.52), the CasaOS client component is stuck requesting the old v1.42 API.
✅ The Solution: Force the Correct Docker API Version We resolve this by forcing the casaos-app-management service to use the higher API version supported by your Docker Engine (e.g., v1.52) using the DOCKER_API_VERSION environment variable.
Step 1: Find the Exact Service File Location First, confirm the exact path of the service file. The output will show the path next to Loaded::
Bash
sudo systemctl status casaos-app-management The common path is usually: /usr/lib/systemd/system/casaos-app-management.service
Step 2: Edit the Service File Use your preferred text editor (e.g., nano or xed) to open the service file. Remember to use sudo:
Bash
sudo nano /usr/lib/systemd/system/casaos-app-management.service
Use the path found in Step 1 if different!
Step 3: Add the Environment Variable Locate the [Service] section and add the Environment="DOCKER_API_VERSION=X.XX" line before the ExecStart line.
Note: Replace 1.52 below with the API version your Docker Engine supports (you can check with docker version --format '{{.Server.APIVersion}}').
Corrected Service File Content:
Ini, TOML
[Unit] After=casaos-message-bus.service After=docker.service Description=CasaOS App Management Service
[Service] ExecStartPre=/usr/bin/casaos-app-management -v Environment="DOCKER_API_VERSION=1.52" # <-- ADD THIS LINE ExecStart=/usr/bin/casaos-app-management -c /etc/casaos/app-management.conf PIDFile=/var/run/casaos/app-management.pid Restart=always Type=notify
[Install] WantedBy=multi-user.target
Step 4: Reload and Restart the Service Finally, reload the systemd configuration and restart the CasaOS component to apply the fix:
Bash
sudo systemctl daemon-reload sudo systemctl restart casaos-app-management The CasaOS App Store should now load correctly upon refreshing your browser.
Thank you for the how to fix!
In a perfect world, the casaos team, will solve the problem with a new release …..
In a perfect world, the casaos team, will solve the problem with a new release …..
we all are hoping so, never give up on hoping :D
Hi all! Sorry for the long wait, with the help of Sabitech, the installation script has been fixed 🙂 , now you can just do a clean install or use the current installation script to fix the previous docker app not loading. The new script has the following features:
Install the latest available Docker engine instead of Docker 24.0.7
Apply a Docker API compatibility override for newer Docker versions
Allow CasaOS services and baked-in apps to work with modern Docker
Please rest assured that we will continue to improve user experience and working hard to ensure compatibility across multiple platforms.