Si le programme d’installation de CasaOS s’arrête sur Ubuntu 24.04 avec ERROR: '24.0.7' not found amongst apt-cache madison results, l’erreur provient d’un décalage historique entre le programme d’installation et la version de Docker, et non d’un paquet Ubuntu manquant qu’il faudrait réinstaller de force. Le rapport de novembre 2025 de la communauté IceWhale a reproduit l’échec sur une nouvelle machine Ubuntu 24.04 LTS, alors même que Docker 29.0.1 était déjà installé et fonctionnel.
Le point important est que ce problème précis du programme d’installation a été corrigé par la suite. En décembre 2025, les responsables de CasaOS ont indiqué que le script d’installation avait été mis à jour pour installer la dernière version disponible de Docker Engine au lieu de fixer Docker à la version 24.0.7, et pour appliquer une gestion de compatibilité de l’API Docker avec les versions plus récentes. Le script d’installation actuel de CasaOS n’expose plus l’ancienne valeur codée en dur 24.0.7 dépendance observée dans le fil de discussion d’origine.
À quoi ressemblait l’erreur du programme d’installation original de CasaOS
Le membre de la communauté a installé CasaOS avec :
curl -fsSL https://get.casaos.io | sudo bashet a également essayé :
export INSTALL_DOCKER=falsemais le programme d’installation est tout de même passé à l’étape des dépendances Docker et a recherché une version précise dans le dépôt APT de Docker :
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 resultsL’hôte disposait déjà de Docker Engine 29.0.1. L’échec s’est produit avant que CasaOS puisse terminer l’installation, car le dépôt Noble de Docker ne contenait plus la version de paquet attendue par l’ancien script.
Pourquoi Ubuntu 24.04 n’a pas pu trouver Docker CE 24.0.7
L’ancien programme d’installation demandait en pratique au dépôt Ubuntu 24.04 de Docker une version de paquet qui n’y était plus disponible. L’exécution de :
apt-cache madison docker-cea confirmé qu’aucune entrée correspondant à la version 24.0.7 n’existait.
Le membre de la communauté gelbuilding a correctement décrit ce problème comme un décalage temporel entre le programme d’installation et le dépôt de paquets Docker. À l’époque, l’utilisation d’une distribution plus ancienne prise en charge, comme Ubuntu 22.04 ou Debian 12, était suggérée comme solution de contournement la plus simple en attendant la mise à jour du programme d’installation.
Ce que CasaOS a changé après l’échec de 2025
La discussion ultérieure sur GitHub consacrée à CasaOS et au même incident de compatibilité Docker indiquait que le script d’installation avait été corrigé. Le comportement mis à jour était décrit comme suit :
- installer la dernière version disponible de Docker Engine au lieu de Docker 24.0.7 ;
- appliquer une modification de compatibilité de l’API Docker pour les versions modernes de Docker ;
- permettre aux services de CasaOS et à la gestion intégrée des applications de fonctionner avec les versions récentes de Docker.
Le code source de l’installateur actuel définit également une version majeure minimale de Docker au lieu d’imposer Docker CE 24.0.7. Vous pouvez consulter l’script d’installation actuel de CasaOS.
Méthode actuelle d’installation de CasaOS
Le dépôt actuel de CasaOS documente toujours l’installateur standard en une ligne :
curl -fsSL https://get.casaos.io | sudo bashou :
wget -qO- https://get.casaos.io | sudo bashConsultez les instructions actuelles d’installation de CasaOS sur GitHub.
Ne rétrogradez pas Docker vers la version 24.0.7 comme première solution aujourd’hui
Lorsque la publication de la communauté a été créée, chercher un moyen de restaurer Docker 24.0.7 était compréhensible, car l’installateur exigeait explicitement cette version. Maintenant que l’installateur lui-même a été mis à jour, forcer le retour d’un paquet Docker obsolète sur Ubuntu 24.04 est généralement une mauvaise première étape.
Rétrograder Docker peut créer d’autres problèmes de compatibilité et de sécurité, et mélanger les versions d’Ubuntu ou les dépôts de paquets uniquement pour ressusciter une version historique peut laisser l’hôte dans un état de paquets non pris en charge.
Pour une installation actuelle, commencez par l’installateur CasaOS actuel et l’état actuel du dépôt Docker.
Comment vérifier que vous utilisez encore un ancien installateur
Si vous voyez toujours :
Recherche dans le dépôt de la VERSION « 24.0.7 »vous exécutez presque certainement un installateur mis en cache, miroir, modifié ou tiers plutôt que le script actuel.
Vérifiez l’origine du script. Évitez de copier un ancien casaos-install.sh depuis une pièce jointe de forum ou un dépôt d’automatisation obsolète, alors que le script amont actuel est disponible.
Que faire si Docker est déjà installé ?
L’auteur d’origine avait déjà installé Docker 29.0.1. Un installateur actuel devrait détecter une installation Docker acceptable et fonctionner avec celle-ci, au lieu d’exiger l’ancien paquet mentionné dans le fil source.
Avant d’installer CasaOS, vérifiez :
docker --version
docker version
systemctl status dockerSi Docker fonctionne correctement mais que l’installation actuelle de CasaOS échoue toujours, capturez la sortie complète de l’installateur avant de supprimer Docker. L’échec actuel peut avoir une cause différente du bogue historique de la version 24.0.7.
Ubuntu 24.04 n’est pas identique à l’hôte recommandé le plus conservateur pour CasaOS
Le dépôt actuel de CasaOS répertorie Debian 12 comme système d’exploitation testé et recommandé, et répertorie séparément d’autres plateformes prises en charge ou testées par la communauté. Les installations Ubuntu peuvent fonctionner, mais le niveau exact de test varie selon la version.
Si vous construisez un serveur domestique de production et souhaitez réduire au minimum les opérations de dépannage, utilisez un système d’exploitation hôte explicitement répertorié par CasaOS comme testé et recommandé, plutôt que de supposer que chaque nouvelle version d’Ubuntu fait immédiatement l’objet d’une validation par l’installateur.
Ne désactivez pas la vérification TLS pour contourner une erreur d’installateur sans rapport
CasaOS a connu par le passé des incidents distincts liés au certificat sur get.casaos.io. Un problème de certificat TLS est différent du problème de paquet Docker 24.0.7.
Si curl signale une erreur de vérification du certificat, n’ajoutez pas automatiquement -k ou désactiver globalement la vérification des certificats. Cela modifie le modèle de confiance du téléchargement de l’installateur et ne doit pas être mélangé au dépannage des paquets Docker.
Procédure actuelle de dépannage
- Vérifiez le système d’exploitation hôte et l’architecture.
- Exécutez
docker --versionet vérifiez que Docker fonctionne correctement s’il est déjà installé. - Utilisez l’installateur actuel depuis
get.casaos.io, et non une ancienne copie locale. - Si la sortie demande toujours explicitement Docker 24.0.7, arrêtez-vous et vérifiez la source du script.
- N’ajoutez pas d’anciens dépôts Ubuntu uniquement pour récupérer Docker 24.0.7.
- Ne rétrogradez pas Docker avant d’avoir confirmé une exigence de compatibilité actuelle.
- Enregistrez le journal complet de l’installateur si le script actuel échoue pour une autre raison.
FAQ de l’installateur de CasaOS Docker 24.0.7
Pourquoi CasaOS a-t-il indiqué que Docker CE 24.0.7 était introuvable ?
L’installateur historique recherchait explicitement cette version dans le dépôt Docker. En novembre 2025, le dépôt Ubuntu 24.04 Noble ne la proposait plus, ce qui interrompait l’installation.
L’installateur actuel de CasaOS nécessite-t-il toujours Docker 24.0.7 ?
La source actuelle de l’installateur en amont n’indique plus l’ancienne exigence fixe de Docker 24.0.7, et les responsables de la maintenance de CasaOS ont indiqué en décembre 2025 que l’installateur avait été mis à jour pour utiliser la dernière version disponible de Docker Engine avec une gestion de la compatibilité.
Dois-je installer Docker 24.0.7 manuellement ?
Pas comme correctif actuel habituel. Il s’agissait d’une cible de paquet historique. Commencez par utiliser l’installateur actuel et les paquets Docker actuels.
CasaOS peut-il fonctionner avec des versions plus récentes de Docker ?
Le travail effectué sur l’installateur et la compatibilité après l’incident de 2025 visait précisément à permettre à CasaOS de fonctionner avec les versions modernes de Docker. Si une version actuelle échoue, diagnostiquez l’erreur exacte de l’API ou du service au lieu de supposer que toutes les versions modernes de Docker ne sont pas prises en charge.
