CasaOS [Feedback] Failed to load apps, please refresh later.

I just installed Casa OS and neither the app store nor the files appear. Help.

Nov 13 '25 10:11 andyCASAOS

Here's a screenshot of the error:

and here's the output of the casaos-app-management:

riccardobellitto@sector5:~$ sudo journalctl -u casaos-app-management -n 20 --no-pager | grep -i "error|app" Nov 13 12:36:20 sector5 casaos-app-management[119653]: 2025-11-13T12:36:20.188+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:20 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:20.188134085+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":1899371,"latency_human":"1.899371ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:25 sector5 casaos-app-management[119653]: 2025-11-13T12:36:25.625+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:25 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:25.625855259+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":2449043,"latency_human":"2.449043ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:28 sector5 casaos-app-management[119653]: 2025-11-13T12:36:28.260+0100 error Failed to get container_list {"err": "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", "func": "service.getContainerStats", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/service/container.go", "line": 99} Nov 13 12:36:30 sector5 casaos-app-management[119653]: 2025-11-13T12:36:30.625+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:30 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:30.625888416+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":1925223,"latency_human":"1.925223ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:35 sector5 casaos-app-management[119653]: 2025-11-13T12:36:35.629+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:35 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:35.629206662+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":2345523,"latency_human":"2.345523ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:37 sector5 casaos-app-management[119653]: 2025-11-13T12:36:37.263+0100 error Failed to get container_list {"err": "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", "func": "service.getContainerStats", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/service/container.go", "line": 99} Nov 13 12:36:40 sector5 casaos-app-management[119653]: 2025-11-13T12:36:40.631+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:40 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:40.631137857+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":1885519,"latency_human":"1.885519ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:45 sector5 casaos-app-management[119653]: 2025-11-13T12:36:45.622+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:45 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:45.622432706+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":1923315,"latency_human":"1.923315ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:46 sector5 casaos-app-management[119653]: 2025-11-13T12:36:46.267+0100 error Failed to get container_list {"err": "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", "func": "service.getContainerStats", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/service/container.go", "line": 99} Nov 13 12:36:50 sector5 casaos-app-management[119653]: 2025-11-13T12:36:50.617+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:50 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:50.617601223+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":2379320,"latency_human":"2.37932ms","bytes_in":0,"bytes_out":159} Nov 13 12:36:55 sector5 casaos-app-management[119653]: 2025-11-13T12:36:55.269+0100 error Failed to get container_list {"err": "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", "func": "service.getContainerStats", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/service/container.go", "line": 99} Nov 13 12:36:55 sector5 casaos-app-management[119653]: 2025-11-13T12:36:55.624+0100 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", "func": "v2.(*AppManagement).GetAppGrid", "file": "/home/runner/work/CasaOS-AppManagement/CasaOS-AppManagement/route/v2/internal_web.go", "line": 27} Nov 13 12:36:55 sector5 casaos-app-management[119653]: {"time":"2025-11-13T12:36:55.624737321+01:00","id":"","remote_ip":"192.168.178.23","host":"192.168.178.37","method":"GET","uri":"/v2/app_management/web/appgrid","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","status":500,"error":"","latency":1913130,"latency_human":"1.91313ms","bytes_in":0,"bytes_out":159}

Nov 13 '25 11:11 riccardobellitto

Just to clarify: my docker version is the latest available

riccardobellitto@sector5:~$ docker version Client: Docker Engine - Community Version: 29.0.0 API version: 1.52 Go version: go1.25.4 Git commit: 3d4129b Built: Mon Nov 10 21:47:17 2025 OS/Arch: linux/arm64 Context: default

Server: Docker Engine - Community Engine: Version: 29.0.0 API version: 1.52 (minimum version 1.44) Go version: go1.25.4 Git commit: d105562 Built: Mon Nov 10 21:47:17 2025 OS/Arch: linux/arm64 Experimental: false containerd: Version: v2.1.5 GitCommit: fcd43222d6b07379a4be9786bda52438f0dd16a1 runc: Version: 1.3.3 GitCommit: v1.3.3-0-gd842d771 docker-init: Version: 0.19.0 GitCommit: de40ad0

Nov 13 '25 11:11 riccardobellitto

Same issue

Nov 13 '25 12:11 FerrumLogic

This problem occurs all over the world.

Nov 13 '25 12:11 dogukansahil

Yes I meet the same problem!

Nov 13 '25 12:11 toplinuxsir

i just did some search. casaos can't identify the newer docker. so it's giving this error i hope the devs will fix it soon. i won't create another issue :)

Nov 13 '25 12:11 nx-smul

i just did some search. casaos can't identify the newer docker. so it's giving this error i hope the devs will fix it soon. i won't create another issue :)

Would downgrading be useful?

Nov 13 '25 13:11 dogukansahil

Downgrade Docker.

Nov 13 '25 13:11 Amila999

Downgrade Docker.

I'm taking backups and will downgrade when they're done.

Nov 13 '25 13:11 dogukansahil

I noticed that CasaOS is unable to recognize the newer Docker versions (especially 29.x). It seems to be a global issue: the App Management service in CasaOS is not compatible with the latest Docker API version, which causes the App Store and other sections to fail loading.

On my own system, switching back to an older Docker version that is known to work with CasaOS immediately restored everything. The App Store, file manager, and all services became visible again, and my data and settings remained intact.

This looks like something that will require an update on the CasaOS side. I’m only sharing my experience here, in case it helps others facing the same problem.

Nov 13 '25 14:11 dogukansahil

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

Nov 13 '25 15:11 onefish2

thank you onefish2, that worked for me

Nov 13 '25 23:11 mandms100

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:

Update Package

sudo apt update

install the packages required to add the repository

sudo apt install ca-certificates curl

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

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

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

sudo apt update

Stop docker

sudo systemctl stop docker

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

Prevent Ubuntu from automatically upgrading Docker:

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

Start Docker again

sudo systemctl start docker
sudo systemctl enable docker

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

Nov 14 '25 01:11 sonarta

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

Thanks! This also worked for me but in my case, I had to completely restart the machine which is a Raspberry Pi 5. 👍

Nov 14 '25 04:11 x3llaz

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

This worked great. Are there any downsides to doing this? Will it need to be changed or reverted at a later time?

Nov 14 '25 20:11 scrosler

@scrosler, from doing some research, the only downside is that the API version 1.24 will be deprecated at some point in the future. But from what I read that is years away. Maybe 2?

Today you have 2 choices. Downgrade docker like you see above or use the directions that I shared.

Nov 14 '25 20:11 onefish2

Docker Downgrade: 29.x → 27.x (Stable for CasaOS)

sudo systemctl stop docker
sudo apt remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo apt update
sudo apt install -y \
  docker-ce=5:27.3.1-1~debian.12~bookworm \
  docker-ce-cli=5:27.3.1-1~debian.12~bookworm \
  containerd.io=1.7.20-1 \
  docker-buildx-plugin=0.16.2-1~debian.12~bookworm \
  docker-compose-plugin=2.29.1-1~debian.12~bookworm

sudo systemctl enable docker
sudo systemctl start docker

Explanation

These commands remove the incompatible Docker 29.x release and install the stable 27.3.1 version, which works correctly with CasaOS. Containers and volumes under /var/lib/docker remain intact because only the Docker engine is replaced.

Disclaimer

This procedure modifies low-level system components. Any data loss, configuration issues, or service interruptions are the user's responsibility. Evaluate your system before running these commands.

Nov 15 '25 18:11 dogukansahil

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

Thank you! this works! my machine is zimablade.

Nov 16 '25 09:11 syagawa

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

Tanx, Fix the problem. My machines are a Pi4 (home automation) and a OMV - i3-7100 based NAS

Nov 16 '25 10:11 AJK-77

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

Another +1 for this, thanks @onefish2.

Docker Downgrade: 29.x → 27.x (Stable for CasaOS)

sudo systemctl stop docker sudo apt remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo apt update sudo apt install -y
docker-ce=5:27.3.1-1~debian.12~bookworm
docker-ce-cli=5:27.3.1-1~debian.12~bookworm
containerd.io=1.7.20-1
docker-buildx-plugin=0.16.2-1~debian.12~bookworm
docker-compose-plugin=2.29.1-1~debian.12~bookworm

sudo systemctl enable docker sudo systemctl start docker

@dogukansahil Wouldn't it be wise to also mark the packages as hold?

Nov 16 '25 13:11 Prodeguerriero

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

thank you onefish2, that worked for me

Nov 16 '25 13:11 KMKAMRAN

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:

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

works!!!!

Nov 16 '25 20:11 renepante

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

thank you, worked for me

Nov 18 '25 16:11 haideidaniel

Claro que sim! Aqui está a solução formatada em inglês, pronta para ser publicada num fórum ou no GitHub, para ajudar outros utilizadores.

🛠️ 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" SOLUTION

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::

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:

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:

[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:

sudo systemctl daemon-reload
sudo systemctl restart casaos-app-management

The CasaOS App Store should now load correctly upon refreshing your browser.

Nov 19 '25 22:11 fpmorais

For me @dogukansahil's fix saved my Debian server. Thank you so much! For the moment I will not update docker until it gets officially fixed... :c

Nov 20 '25 12:11 GabubuAvailable

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

Thanks, this one is a straightforward workaround.

Nov 20 '25 13:11 mariodian

Claro que sim! Aqui está a solução formatada em inglês, pronta para ser publicada num fórum ou no GitHub, para ajudar outros utilizadores.

🛠️ 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" SOLUTION

Thank you it worked

Nov 20 '25 18:11 kuspys

Claro que sim! Aqui está a solução formatada em inglês, pronta para ser publicada num fórum ou no GitHub, para ajudar outros utilizadores.

🛠️ 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" SOLUTION

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::

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:

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:

[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:

sudo systemctl daemon-reload sudo systemctl restart casaos-app-management The CasaOS App Store should now load correctly upon refreshing your browser.

BIG W

Nov 22 '25 11:11 cenmurong

A workaround without the need to downgrade docker version or portainer, which is to manually lower the minimum API version of docker:

systemctl edit docker.service

Add this part above the line ### Lines below this comment will be discarded:

[Service] Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit systemctl restart docker

@onefish2 , Thank you, this one works well for me and all is good. However, should I expect any impact on other applications by limiting DOCKER_MIN_API_VERSION to 1.24?

Nov 23 '25 17:11 genius-kh

Claro que sim! Aqui está a solução formatada em inglês, pronta para ser publicada num fórum ou no GitHub, para ajudar outros utilizadores.

🛠️ 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" SOLUTION

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::

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:

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:

[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:

sudo systemctl daemon-reload sudo systemctl restart casaos-app-management The CasaOS App Store should now load correctly upon refreshing your browser.

Thanks Brah!

Nov 24 '25 06:11 vdubbus77