[Bug] Docker 5.29 update in Debian/Ubuntu breaking Casa OS Web UI for apps

[hitenmistry75]

Describe the bug

latest apt update for docker is stopping apps showing in the UI

To Reproduce

Steps to reproduce the behavior:

Update docker on linux

Expected behavior
UI breaks

A clear and concise description of what you expected to happen.

Screenshots

If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

Ubuntu 22.04 and 24.04

[vitorhugoaranda]

+1

[0ddL33]

Issue seems to be CasaOS needs Docker API 1.44+

[chchia]

+1

[Dev01-D]

Afternoon all, the dev team have been alerted of this and will be looking into it (current time there approx 22:00)
Rest assured they will be investigating the nature of the issue and from our understanding the apps still run but not showing in the dashboard.

[chchia]

Afternoon all, the dev team have been alerted of this and will be looking into it (current time there approx 22:00) Rest assured they will be investigating the nature of the issue and from our understanding the apps still run but not showing in the dashboard.

LOL I didnt expect the dev team living the same time zone as me....

[x3llaz]

+1
Having exactly the same problems after updating docker today.

[flippz]

roll back to docker 5.28 solves till devs come with a patch

[dragonfire1119]

Hello everybody I made a script to try to make this seamless on getting it fixed: https://community.bigbeartechworld.com/t/fix-docker-api-version-error-for-casaos-app-not-loading/5104 Always backup data before running.

[fseesink]

For those running CasaOS under Ubuntu 24.04 LTS, the steps here are the cleanest/simplest I found for reverting back to Docker Engine 28.5.2. Similar steps (with the package names adjusted properly, of course) should work for other Debian-based distros. It also sets things to prevent upgrading again to v29 when doing normal maintenance (e.g., sudo apt-get update && sudo apt-get upgrade).

And it has the step to unmark the packages later once CasaOS is updated so that you can update to the latest Docker.

[fseesink]

Some are blaming CasaOS for not having updated their version of the Docker API on the client side.

But I squarely blame Docker for this one. They did not properly telegraph this breaking change well in advance as they should have. Something THIS breaking should have been announced loudly a long time ago.

It is quite something to release a version that suddenly only supports API calls from v1.44 and up (considering just how many API versions there have been!). Traefik, for example, is supposedly still using Docker API v1.24. So this Docker Engine update has also impacted anyone running Traefik. Portainer was another casualty.

And the fact that distros like Ubuntu 24.04 LTS are already pushing Docker Engine v29 when Docker's own release notes (for EITHER Docker Engine or the API) still don't show these latest versions (v29 for the engine and v1.52 for the API) indicates that Docker released this without first updating their docs either.

So that folks would not be expecting apps to break is completely understandable.

[Hugopvigo]

+1

[sonarta]

I had the same issue and just downgraded docker back to 28.5.2 and it instantly fixed the issue.

Here are the steps if you need them for ubuntu:

1. Update Package

sudo apt update

2. install the packages required to add the repository

sudo apt install ca-certificates curl

3. Add Docker's official GPG key:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

4. Add the repository to APT sources:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Update the package index again (to include the new Docker packages):

sudo apt update

6. Stop docker

sudo systemctl stop docker

7. Install the specific Docker version

sudo apt install docker-ce=5:28.5.2-1~ubuntu.24.04~noble \
                 docker-ce-cli=5:28.5.2-1~ubuntu.24.04~noble \
                 containerd.io

8. Prevent Ubuntu from automatically upgrading Docker:

sudo apt-mark hold docker-ce docker-ce-cli

9. Start Docker again

sudo systemctl start docker
sudo systemctl enable docker

10. Verify the version

docker --version

You should see:

Docker version 28.5.2, build ...

Once this issue has been fixed you can run the following to update docker back

sudo apt-mark unhold docker-ce docker-ce-cli