[Feedback]Failed app
Applications won't load after updating Linux Mint
Solution Solved
🛠️ CasaOS App Store Fix: Docker API Version Incompatibility This solution addresses the common CasaOS error when trying to load the App Store, which results in the message:
"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.
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.