BUG - Failed to load apps, please refresh later

[pauloz10]

My icons are not loading, my apps work that are managed by CasaOS. I have installed again, same result. I have made sure docker.service is running.

[GeekyTim]

See #2407

[fpmorais]

Solution Solved With Gemini and lots of time!

🛠️ 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.

[mattish91]

Environment="DOCKER_API_VERSION=1.52"

Man! You are my hero! this totally solves this issue!

Thank you!