🐳 Fix CasaOS - Failed to load apps, please refresh later

📆 2025-11:20 11:02

If you run CasaOS on your servers you might have seen that after the latest docker update to version 29.0.2 the apps under CasaOS no longer appear and an error is shown saying:

Failed to load apps, please refresh later

🚧 Finding the problem

If we take a look at

journalctl -xeu casaos-app-management --no-pager

we can see that Docker wants a newer client after the update because Docker versions older than v25 are now end of life, and as such, the Minimum API version is increased to 1.44 (Moby v25):

error        
failed to list compose apps with store info        
{"error": "Error response from daemon: client version 1.43 is too old. 
Minimum supported API version is 1.44, 
please upgrade your client to a newer version", 
etc ...}

🛠️ The solution

The fix is quite simple but not a long term solution. All you have to do is to edit the docker service config:

sudo systemctl edit docker.service

and add:

[Service]
Environment=DOCKER_MIN_API_VERSION=1.24

above the line

### Lines below this comment will be discarded:

And, of course, restart docker:

sudo systemctl restart docker

The apps and app store should work. I hope IceWhaleTech will get CasaOS updated soon ...

If you aren't using CasaOS yet you might want to give it a try