CasaOS icon indicating copy to clipboard operation
CasaOS copied to clipboard

[Feedback]Failed app

Open Jurimamontov opened this issue 1 month ago • 3 comments

Jurimamontov avatar Nov 14 '25 18:11 Jurimamontov

Applications won't load after updating Linux Mint

Jurimamontov avatar Nov 14 '25 18:11 Jurimamontov

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.

fpmorais avatar Nov 22 '25 00:11 fpmorais

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.

Dev01-D avatar Dec 10 '25 20:12 Dev01-D