Communityoplossing

CasaOS-installatieprogramma herstellen: Docker 24.0.7 niet gevonden op 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.

Als het CasaOS-installatieprogramma op Ubuntu 24.04 stopt met ERROR: '24.0.7' not found amongst apt-cache madison results, de fout komt door een historische mismatch tussen het installatieprogramma en de Docker-versie en niet door een ontbrekend Ubuntu-pakket dat je geforceerd opnieuw in het systeem zou moeten installeren. Het IceWhale Community-rapport uit november 2025 reproduceerde de fout op een nieuwe Ubuntu 24.04 LTS-machine, ook al was Docker 29.0.1 al geïnstalleerd en actief.

De belangrijke tijdsgrens is dat deze specifieke fout in het installatieprogramma later werd verholpen. In december 2025 meldden CasaOS-beheerders dat het installatiescript was bijgewerkt om de laatst beschikbare Docker Engine te installeren in plaats van Docker 24.0.7 vast te zetten, en om compatibiliteit met de Docker API voor nieuwere Docker-versies toe te passen. Het huidige CasaOS-installatiescript bevat de oude hardgecodeerde 24.0.7 afhankelijkheid die in de oorspronkelijke thread werd gezien.

Hoe de oorspronkelijke CasaOS-installatiefout eruitzag

De communityauteur installeerde CasaOS met:

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

en probeerde ook:

export INSTALL_DOCKER=false

maar het installatieprogramma ging nog steeds naar de Docker-afhankelijkheidsfase en zocht in de Docker APT-repository naar één exacte versie:

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

Op de host stond Docker Engine 29.0.1 al geïnstalleerd. De fout trad op voordat CasaOS de installatie kon voltooien, omdat de Noble-repository van Docker de pakketversie die het historische script verwachtte niet meer bevatte.

Waarom Ubuntu 24.04 Docker CE 24.0.7 niet kon vinden

Het historische installatieprogramma vroeg de Ubuntu 24.04-repository van Docker feitelijk om een pakketversie die daar niet meer beschikbaar was. Uitvoeren van:

apt-cache madison docker-ce

bevestigde dat er geen overeenkomende vermelding voor 24.0.7 bestond.

Communitylid gelbuilding beschreef dit correct als een timingprobleem tussen het installatieprogramma en de Docker-pakketrepository. Destijds werd het gebruik van een oudere ondersteunde distributie, zoals Ubuntu 22.04 of Debian 12, aangeraden als workaround met de minste frictie in afwachting van een update van het installatieprogramma.

Wat CasaOS na de storing van 2025 heeft gewijzigd

De latere GitHub-discussie van CasaOS over hetzelfde Docker-compatibiliteitsincident meldde dat het installatiescript was hersteld. Het bijgewerkte gedrag werd als volgt beschreven:

  • de laatst beschikbare Docker Engine installeren in plaats van Docker 24.0.7;
  • een Docker API-compatibiliteitsoverschrijving toepassen voor moderne Docker-releases;
  • ervoor zorgen dat CasaOS-services en het ingebouwde appbeheer werken met nieuwere Docker-versies.

De broncode van het huidige installatieprogramma definieert ook een minimale hoofdversie van Docker in plaats van Docker CE 24.0.7 hard te coderen. Je kunt het huidige CasaOS-installatiescript bekijken.

Huidige installatiemethode voor CasaOS

De huidige CasaOS-repository documenteert nog steeds het standaardinstallatieprogramma in één regel:

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

of:

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

Bekijk de huidige installatie-instructies voor CasaOS op GitHub.

Downgrade Docker vandaag niet als eerste oplossing naar 24.0.7

Toen het communitybericht werd geschreven, was het begrijpelijk dat men zocht naar een manier om Docker 24.0.7 te herstellen, omdat het installatieprogramma expliciet die versie vereiste. Nu het installatieprogramma zelf is bijgewerkt, is het meestal niet de juiste eerste stap om een verouderd Docker-pakket terug op Ubuntu 24.04 te zetten.

Het downgraden van Docker kan andere compatibiliteits- en beveiligingsproblemen veroorzaken. Het mengen van Ubuntu-versies of pakketbronnen om slechts één historische versie nieuw leven in te blazen, kan de host bovendien in een niet-ondersteunde pakketstatus achterlaten.

Gebruik voor een huidige installatie het huidige CasaOS-installatieprogramma en de huidige status van de Docker-repository als uitgangspunt.

Zo controleer je of je nog steeds een oud installatieprogramma gebruikt

Als je nog steeds het volgende ziet:

Repository doorzoeken naar VERSION '24.0.7'

je voert vrijwel zeker een oudere, gecachte, gespiegelde, aangepaste of externe versie van het installatieprogramma uit in plaats van het huidige script.

Controleer waar het script vandaan komt. Vermijd het kopiëren van een oud casaos-install.sh uit een forum-bijlage of verouderde automatiseringsrepository, terwijl het huidige upstream-script beschikbaar is.

Wat als Docker al geïnstalleerd is?

De oorspronkelijke auteur had Docker 29.0.1 al geïnstalleerd. Een huidig installatieprogramma hoort een aanvaardbare Docker-installatie te detecteren en ermee te werken, in plaats van het verouderde pakket uit de brondiscussie te vereisen.

Controleer het volgende voordat je CasaOS installeert:

docker --version
docker version
systemctl status docker

Als Docker goed werkt maar de huidige CasaOS-installatie nog steeds mislukt, leg dan de volledige uitvoer van het installatieprogramma vast voordat je Docker verwijdert. Een huidige fout kan een andere oorzaak hebben dan de historische bug in 24.0.7.

Ubuntu 24.04 is niet hetzelfde als de meest conservatieve aanbevolen host voor CasaOS

De huidige CasaOS-repository vermeldt Debian 12 als getest en aanbevolen besturingssysteem en vermeldt daarnaast andere ondersteunde of door de community geteste platforms. Ubuntu-installaties kunnen werken, maar het exacte testniveau verschilt per release.

Als je een productieserver voor thuis bouwt en zo min mogelijk tijd aan probleemoplossing wilt besteden, gebruik dan een hostbesturingssysteem dat CasaOS expliciet als getest/aanbevolen vermeldt, in plaats van aan te nemen dat elke nieuwe Ubuntu-release onmiddellijk door het installatieprogramma wordt gevalideerd.

Schakel TLS-verificatie niet uit om een niet-gerelateerde installatiefout te omzeilen

Bij CasaOS zijn in het verleden afzonderlijke incidenten geweest met het certificaat op get.casaos.io. Een TLS-certificaatprobleem verschilt van het probleem met het Docker 24.0.7-pakket.

Als curl meldt een certificaatverificatiefout; voeg niet automatisch -k of schakel de certificaatverificatie globaal uit. Daarmee verandert het vertrouwensmodel van de installatiedownload, en dit moet niet worden vermengd met het oplossen van problemen met Docker-pakketten.

Huidige workflow voor probleemoplossing

  1. Bevestig het besturingssysteem en de architectuur van de host.
  2. Voer uit docker --version en bevestig dat Docker correct werkt als het al is geïnstalleerd.
  3. Gebruik het huidige installatieprogramma van get.casaos.io, niet een oude lokale kopie.
  4. Als de uitvoer nog steeds expliciet om Docker 24.0.7 vraagt, stop dan en controleer de broncode van het script.
  5. Voeg geen oude Ubuntu-repositories toe alleen om Docker 24.0.7 terug te krijgen.
  6. Downgrade Docker niet voordat je hebt bevestigd dat er een huidige compatibiliteitsvereiste is.
  7. Sla het volledige installatielogboek op als het huidige script om een andere reden mislukt.

Veelgestelde vragen over het CasaOS-installatieprogramma voor Docker 24.0.7

Waarom zei CasaOS dat Docker CE 24.0.7 niet was gevonden?

Het historische installatieprogramma zocht expliciet in de Docker-repository naar die versie. In november 2025 bood de Ubuntu 24.04 Noble-repository die versie niet langer aan, waardoor de installatie stopte.

Vereist het huidige CasaOS-installatieprogramma nog steeds Docker 24.0.7?

De huidige broncode van het upstream-installatieprogramma vermeldt niet langer de oude vaste vereiste voor Docker 24.0.7, en CasaOS-onderhouders meldden in december 2025 dat het installatieprogramma was bijgewerkt om de nieuwste beschikbare Docker Engine te gebruiken, met compatibiliteitsafhandeling.

Moet ik Docker 24.0.7 handmatig installeren?

Niet als de gebruikelijke huidige oplossing. Dat was een historisch pakketdoel. Begin met het huidige installatieprogramma en de huidige Docker-pakketten.

Kan CasaOS met nieuwere Docker-releases werken?

Het installatie- en compatibiliteitswerk dat na het incident in 2025 is uitgevoerd, was specifiek bedoeld om CasaOS met moderne Docker-versies te laten werken. Als een huidige release mislukt, stel dan de exacte API- of servicefout vast in plaats van aan te nemen dat elke moderne Docker-versie niet wordt ondersteund.