CasaOS [Feedback]Can't get apps to load or update

Getting constant failed to load apps, please refresh later.

Nov 10 '25 00:11 nestormcdade

same issue! :(

Nov 10 '25 23:11 mymel2001-holder

update - try this fix (until IceWhale updates their code). this is what worked for me:

wget https://download.docker.com/linux/static/stable/x86_64/docker-28.3.2.tgz # Last known good docker for CasaOS tar -xzvf docker-28.3.2.tgz # Extract it. sudo systemctl stop docker # Stop docker sudo systemctl stop containerd # Stop containerd sudo cp docker/* /usr/bin # Copies the older version, replacing the newer one. Default location in Docker's Ubuntu package of docker. Replace with your docker location. sudo systemctl start docker # Restart docker sudo systemctl start containerd # Restart containerd

Nov 11 '25 00:11 mymel2001-holder

Thanks so much for adding the steps to revert.

Nov 11 '25 01:11 saps1960

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

Nov 11 '25 04:11 Fauster

Thx. Fauster that worked for me.

Nov 11 '25 08:11 jone79

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

for ubuntu I used

sudo apt install -y docker-ce=5:28.5.2-1~ubuntu.25.10~questing docker-ce-cli=5:28.5.2-1~ubuntu.25.10~questing containerd.io

Nov 11 '25 09:11 ryd3v

:~# sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.ioReading package lists... DoneBuilding dependency tree... DoneReading state information... Donethe package docker-ce is not available, but is referred to by another package.This may mean that the package is missing, obsolete, oronly available from another sourcethe package docker-ce-cli is not available, but is referred to by another package.This may mean that the package is missing, obsolete, oronly available from another sourceHowever, the following packages replace it:docker-cethe package containerd.io is not available, but is referred to by another package.This may mean that the package is missing, obsolete, oronly available from another sourceE: Version '5:28.3.2~debian.12~bookworm' for 'docker-ce' was not foundE: Version '5:28.3.2~debian.12~bookwo

Nov 11 '25 11:11 vitorhugoaranda

for me using Armbian Trixie, below is none working and working version

Not Working 5:29.0.0-1~debian.13~trixie

Working 5:28.5.2-1~debian.13~trixie

Nov 11 '25 14:11 chchia

how to install? sudo apt install -y docker-ce=5:28.5.2-1debian.13trixie docker-ce-cli=5:28.5.2-1debian.13trixie containerd.io doesnt work here.

''The package docker-ce-cli is unavailable, but is referenced by another package.

This may mean that the package is missing, has become obsolete, or is only available from another source.

However, the following packages replace it:

docker-ce

The package containerd.io is unavailable, but is referenced by another package.

This may mean that the package is missing, has become obsolete, or is only available from another source.

E: Version '5:28.5.2-1debian.13trixie' for 'docker-ce' was not found E: Version '5:28.5.2-1debian.13trixie' for 'docker-ce-cli' was not found E: Package 'containerd.io' has no installation candidate

Nov 11 '25 15:11 vitorhugoaranda

sudo apt update apt-cache policy docker-ce sudo systemctl stop docker sudo systemctl stop docker.socket sudo systemctl stop docker sudo apt remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin sudo apt install -y docker-ce=5:28.5.2-1~debian.13~trixie docker-ce-cli=5:28.5.2-1~debian.13~trixie containerd.io sudo systemctl start docker sudo apt-mark hold docker-ce docker-ce-cli containerd.io

Nov 11 '25 16:11 chchia

i dont know why there is a strikeout line?

anyway below was the command i used.

Nov 11 '25 16:11 chchia

whenever i get to the "sudo install...debian.13" line i get "held packages were changed and -y was used without --allow-change-held-packages."

Nov 11 '25 18:11 Usdrillsgt

FOr me on debian trixie I did:

sudo apt install -y docker-ce=5:28.5.2-1~debian.13~trixie docker-ce-cli=5:28.5.2-1~debian.13~trixie --allow-downgrades

worked fine without pain.

Nov 12 '25 12:11 raphamotta

So another raspberry pi update that's screwed with my system, lost all my casaos apps and not a clue how to get them back, tied a recommended way and cannot install docker now.

managed to install docker back okay, casaos still not working

Nov 12 '25 22:11 thompson09-arch

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

I'm working on Raspberry Pi, and sudo apt install -y docker-ce=5:28.3.2-1~debian.13~trixie docker-ce-cli=5:28.3.2-1~debian.13~trixie containerd.io worked for me.

Nov 13 '25 03:11 AetherManzo

For raspberipi 3

sudo systemctl stop docker.socket docker.service containerd casaos && sleep 5 && sudo pkill -f docker && sudo pkill -f containerd && sync && wget https://download.docker.com/linux/static/stable/aarch64/docker-23.0.0.tgz && tar -xzvf docker-23.0.0.tgz && sudo rm -f /usr/bin/dockerd /usr/bin/docker /usr/bin/containerd /usr/bin/docker-proxy /usr/bin/docker-init /usr/bin/containerd-shim-runc-v2 /usr/bin/ctr /usr/bin/runc && sleep 2 && sudo cp docker/* /usr/bin/ && sudo rm -f /etc/docker/daemon.json && sudo systemctl start containerd && sudo systemctl start docker.service && sudo systemctl start docker.socket && sleep 5 && docker --version && sudo systemctl restart casaos && echo

If CasaOS is still the same, the problem might not be just Docker. Restart CasaOS completely:

sudo systemctl stop casaos && sudo systemctl disable casaos && sudo rm -rf /var/lib/casaos && sudo rm -rf /usr/lib/casaos && curl -fsSL https://get.casaos.io | sudo bash && sudo systemctl start casaos && echo "✅ CasaOS reinstalado! Acesse o interface no browser."

Nov 13 '25 17:11 JBaia

FOr me on debian trixie I did:

sudo apt install -y docker-ce=5:28.5.2-1~debian.13~trixie docker-ce-cli=5:28.5.2-1~debian.13~trixie --allow-downgrades

worked fine without pain.

yeah working fine

Nov 14 '25 10:11 vizavisual

how to install? sudo apt install -y docker-ce=5:28.5.2-1debian.13trixie docker-ce-cli=5:28.5.2-1debian.13trixie containerd.io doesnt work here.

''The package docker-ce-cli is unavailable, but is referenced by another package.

This may mean that the package is missing, has become obsolete, or is only available from another source.

However, the following packages replace it:

docker-ce

The package containerd.io is unavailable, but is referenced by another package.

This may mean that the package is missing, has become obsolete, or is only available from another source.

E: Version '5:28.5.2-1debian.13trixie' for 'docker-ce' was not found E: Version '5:28.5.2-1debian.13trixie' for 'docker-ce-cli' was not found E: Package 'containerd.io' has no installation candidate

i faced the same problem here

Nov 14 '25 18:11 eaglesby

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

i can not install the docker again

Nov 14 '25 18:11 eaglesby

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

sudo apt remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io Where I used to make it run again : sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a 8.Prevent Future Upgrades (Optional) To HOLD the upgrade of Docker until CasaOS is updated: sudo apt-mark hold docker-ce docker-ce-cli containerd.io To UNHOLD the upgrade of Docker until CasaOS is updated: sudo apt-mark unhold docker-ce docker-ce-cli containerd.io Hope this helps!

i can not install the docker again

Nov 14 '25 18:11 AetherManzo

Which distribution are you using? The error you are getting is because the packages for Debian do not exist in your distribution.

Nov 14 '25 18:11 AetherManzo

Buenas , pero yo no quiero instalar un docker mas antiguo , espero pronto hagan un fix para que funcione con la versión 29.0.1

Nov 14 '25 22:11 piposeimandi

Which distribution are you using? The error you are getting is because the packages for Debian do not exist in your distribution.

this version, please help

Nov 15 '25 00:11 eaglesby

This worked for me: https://github.com/orgs/portainer/discussions/12926#discussioncomment-14944622

Nov 15 '25 10:11 tseaward

To install again in debian: sudo apt install -y docker-ce=5:28.3.2-1~debian.12~bookworm docker-ce-cli=5:28.3.2-1~debian.12~bookworm containerd.io

Nov 15 '25 20:11 Vincius-dev

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

Debian 13 sudo apt install -y docker-ce=5:28.5.2-1~debian.13~trixie docker-ce-cli=5:28.5.2-1~debian.13~trixie containerd.io

Nov 17 '25 06:11 jwwright520

Not so painfull way to downgrade on Debian linux:

Update the package list:

sudo apt update

List available docker-ce versions:

apt-cache policy docker-ce

You will see a list of versions. Copy the exact version string (e.g., 5:25.0.5-1~debian.12~bookworm) of the version you want to downgrade to. Example snippet string: 5:28.3.2~debian.12~bookworm /last known running

Stop Docker Service

sudo systemctl stop docker

Remove Current Docker Packages Remove the existing Docker packages using apt remove. This step removes the binaries, but critically, it leaves your configuration files, images, and containers (stored in /var/lib/docker) intact.

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

Warning: Do NOT use sudo apt purge or manually run sudo rm -rf /var/lib/docker, as this will delete all your containers and images.

Install the Specific Older Version

sudo apt install -y docker-ce=[VERSION_STRING] docker-ce-cli=[VERSION_STRING] containerd.io

Where I used to make it run again :

sudo apt install -y docker-ce=5:28.3.2~debian.12~bookworm docker-ce-cli=5:28.3.2~debian.12~bookworm containerd.io

Start the Docker service

sudo systemctl start docker

Verify the new version and check your containers

docker version docker ps -a

8.Prevent Future Upgrades (Optional)

To HOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark hold docker-ce docker-ce-cli containerd.io

To UNHOLD the upgrade of Docker until CasaOS is updated:

sudo apt-mark unhold docker-ce docker-ce-cli containerd.io

Hope this helps!

Sorry in advance for the linux newbie question...I've put a HOLD on the upgrade of the Docker(as you suggest), how will I know when CasaOS is updated that I can UNHOLD the upgrade?

Nov 17 '25 09:11 hinchie

Fix: CasaOS “Failed to Load Apps” on Ubuntu/Armbian (Docker too new)

Issue Summary

On Ubuntu 24.04 (Noble) / Armbian installations, CasaOS may fail to display applications and show:

Failed to load apps, please refresh later

This typically occurs because recent Docker releases (e.g., 29.x) use a newer API version not yet fully supported by CasaOS. As a result, CasaOS cannot communicate with Docker and the App Store fails to load.

Solution

The fix does not require downgrading Docker. Instead, we override Docker’s minimum accepted API version so CasaOS can communicate properly.

Step-by-Step Fix

1) Clean existing Docker installation

sudo systemctl stop docker || true
sudo systemctl stop containerd || true
sudo systemctl stop docker.socket || true

sudo apt remove -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo apt autoremove -y
sudo rm -rf /var/lib/docker /var/lib/containerd

2) Reinstall Docker normally

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

3) Override Docker’s minimum API version

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo nano /etc/systemd/system/docker.service.d/override.conf

Paste the following content:

[Service]
Environment=DOCKER_MIN_API_VERSION=1.24

Save and exit.

4) Reload and restart services

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

5) Test Docker

docker --version
sudo docker run --rm hello-world

If the test passes, refresh CasaOS in your browser. The App Store should now load properly.

Optional: View logs

If issues remain:

journalctl -xeu casaos-app-management --no-pager | tail -n 80

Nov 21 '25 01:11 hfzrfa

Work for me Debian 13 sudo apt install -y docker-ce=5:28.5.2-1~debian.13~trixie docker-ce-cli=5:28.5.2-1~debian.13~trixie containerd.io

Nov 22 '25 04:11 erlamcastanho76

update - try this fix (until IceWhale updates their code). this is what worked for me:

wget https://download.docker.com/linux/static/stable/x86_64/docker-28.3.2.tgz # Last known good docker for CasaOS tar -xzvf docker-28.3.2.tgz # Extract it. sudo systemctl stop docker # Stop docker sudo systemctl stop containerd # Stop containerd sudo cp docker/* /usr/bin # Copies the older version, replacing the newer one. Default location in Docker's Ubuntu package of docker. Replace with your docker location. sudo systemctl start docker # Restart docker sudo systemctl start containerd # Restart containerd

thanks a lot it works 4 me.

Nov 27 '25 05:11 kkaozz