Community Solution

Fix CasaOS Installer Docker 24.0.7 Not Found on Ubuntu 24.04

A November 2025 CasaOS installation on Ubuntu 24.04 failed because the installer searched Docker's repository for the removed Docker CE 24.0.7 package even though Docker 29.0.1 was already installed. The installer was later updated to work with current Docker packages.

If the CasaOS installer stops on Ubuntu 24.04 with ERROR: '24.0.7' not found amongst apt-cache madison results, the error comes from a historical installer/Docker-version mismatch rather than a missing Ubuntu package you should force back into the system. The November 2025 IceWhale Community report reproduced the failure on a fresh Ubuntu 24.04 LTS machine even though Docker 29.0.1 was already installed and working.

The important time boundary is that this exact installer bug was later addressed. In December 2025, CasaOS maintainers reported that the installation script had been updated to install the latest available Docker Engine instead of pinning Docker 24.0.7, and to apply Docker API compatibility handling for newer Docker versions. The current CasaOS installer script no longer exposes the old hardcoded 24.0.7 dependency seen in the original thread.

What the Original CasaOS Installer Error Looked Like

The community author installed CasaOS with:

curl -fsSL https://get.casaos.io | sudo bash

and also tried:

export INSTALL_DOCKER=false

but the installer still entered its Docker dependency stage and searched the Docker APT repository for one exact version:

INFO: Searching repository for VERSION '24.0.7'
apt-cache madison docker-ce | grep '24.0.7'
ERROR: '24.0.7' not found amongst apt-cache madison results

The host already had Docker Engine 29.0.1. The failure occurred before CasaOS could finish installing because Docker's Noble repository no longer contained the package version the historical script expected.

Why Ubuntu 24.04 Could Not Find Docker CE 24.0.7

The historical installer was effectively asking Docker's Ubuntu 24.04 repository for a package version that was no longer available there. Running:

apt-cache madison docker-ce

confirmed that no matching 24.0.7 entry existed.

Community member gelbuilding correctly described this as a timing mismatch between the installer and the Docker package repository. At the time, using an older supported distribution such as Ubuntu 22.04 or Debian 12 was suggested as the lowest-friction workaround while waiting for the installer to be updated.

What CasaOS Changed After the 2025 Failure

The later CasaOS GitHub discussion around the same Docker compatibility incident reported that the installation script had been fixed. The updated behavior was described as:

  • install the latest available Docker Engine instead of Docker 24.0.7;
  • apply a Docker API compatibility override for modern Docker releases;
  • allow CasaOS services and built-in app management to work with newer Docker versions.

Current installer source also defines a minimum Docker major version rather than hardcoding Docker CE 24.0.7. You can review the current CasaOS installer script.

Current CasaOS Installation Method

The current CasaOS repository still documents the standard one-line installer:

curl -fsSL https://get.casaos.io | sudo bash

or:

wget -qO- https://get.casaos.io | sudo bash

See the current CasaOS GitHub installation instructions.

Do Not Downgrade Docker to 24.0.7 as the First Fix Today

When the community post was created, searching for a way to restore Docker 24.0.7 was understandable because the installer explicitly demanded that version. Once the installer itself has been updated, forcing an obsolete Docker package back onto Ubuntu 24.04 is usually the wrong first step.

Downgrading Docker can create other compatibility and security issues, and mixing Ubuntu releases or package repositories only to resurrect one historical version can leave the host in an unsupported package state.

For a current installation, start with the current CasaOS installer and the current Docker repository state.

How to Check Whether You Are Still Using an Old Installer

If you still see:

Searching repository for VERSION '24.0.7'

you are almost certainly executing an older cached, mirrored, modified, or third-party installer rather than the current script.

Check where the script came from. Avoid copying an old casaos-install.sh from a forum attachment or stale automation repository when the current upstream script is available.

What If Docker Is Already Installed?

The original author had Docker 29.0.1 already installed. A current installer should detect and work with an acceptable Docker installation instead of requiring the obsolete package from the source thread.

Before installing CasaOS, check:

docker --version
docker version
systemctl status docker

If Docker is healthy but the current CasaOS installation still fails, capture the complete installer output before removing Docker. A current failure may have a different cause from the historical 24.0.7 bug.

Ubuntu 24.04 Is Not the Same as CasaOS's Most Conservative Recommended Host

The current CasaOS repository lists Debian 12 as a tested and recommended operating system and separately lists other supported or community-tested platforms. Ubuntu installations can work, but the exact level of testing differs by release.

If you are building a production home server and want the least troubleshooting overhead, use a host operating system explicitly listed by CasaOS as tested/recommended rather than assuming every new Ubuntu release receives immediate installer validation.

Do Not Disable TLS Verification to Work Around an Unrelated Installer Error

CasaOS has had separate historical incidents involving the certificate on get.casaos.io. A TLS certificate problem is different from the Docker 24.0.7 package problem.

If curl reports a certificate verification error, do not automatically add -k or globally disable certificate verification. That changes the trust model of the installer download and should not be mixed into Docker-package troubleshooting.

Current Troubleshooting Workflow

  1. Confirm the host operating system and architecture.
  2. Run docker --version and confirm Docker is healthy if already installed.
  3. Use the current installer from get.casaos.io, not an old local copy.
  4. If the output still explicitly requests Docker 24.0.7, stop and verify the script source.
  5. Do not add old Ubuntu repositories solely to recover Docker 24.0.7.
  6. Do not downgrade Docker until you have confirmed a current compatibility requirement.
  7. Save the full installer log if the current script fails for another reason.

CasaOS Docker 24.0.7 Installer FAQ

Why did CasaOS say Docker CE 24.0.7 was not found?

The historical installer explicitly searched the Docker repository for that version. By November 2025, the Ubuntu 24.04 Noble repository no longer offered it, so the installation stopped.

Does the current CasaOS installer still require Docker 24.0.7?

The current upstream installer source no longer shows the old fixed Docker 24.0.7 requirement, and CasaOS maintainers reported in December 2025 that the installer had been updated to use the latest available Docker Engine with compatibility handling.

Should I install Docker 24.0.7 manually?

Not as the normal current fix. That was a historical package target. Start with the current installer and current Docker packages.

Can CasaOS work with newer Docker releases?

The installer and compatibility work performed after the 2025 incident was specifically intended to allow CasaOS to work with modern Docker versions. If a current release fails, diagnose the exact API or service error rather than assuming every modern Docker version is unsupported.