Se il programma di installazione di CasaOS si interrompe su Ubuntu 24.04 con ERRORE: '24.0.7' non trovato tra i risultati di apt-cache madison; l'errore deriva da una mancata corrispondenza storica tra il programma di installazione e la versione di Docker, non da un pacchetto Ubuntu mancante che si dovrebbe forzare nuovamente nel sistema. Il rapporto della IceWhale Community del novembre 2025 ha riprodotto l'errore su una macchina Ubuntu 24.04 LTS appena installata, anche se Docker 29.0.1 era già installato e funzionante.
Il limite temporale importante è che questo specifico bug del programma di installazione è stato successivamente risolto. Nel dicembre 2025, i manutentori di CasaOS hanno riferito che lo script di installazione era stato aggiornato per installare la versione più recente disponibile di Docker Engine invece di fissare Docker 24.0.7 e per applicare la gestione della compatibilità dell'API Docker alle versioni più recenti. Lo script di installazione attuale di CasaOS non espone più il vecchio valore codificato 24.0.7 dipendenza osservata nella discussione originale.
Come appariva l'errore del programma di installazione originale di CasaOS
L'autore della community ha installato CasaOS con:
curl -fsSL https://get.casaos.io | sudo bashe provava anche:
export INSTALL_DOCKER=falsema il programma di installazione entrava comunque nella fase di installazione delle dipendenze Docker e cercava una versione esatta nel repository APT di Docker:
INFO: ricerca nel repository della VERSIONE '24.0.7'
apt-cache madison docker-ce | grep '24.0.7'
ERRORE: '24.0.7' non trovato tra i risultati di apt-cache madisonSul sistema era già installato Docker Engine 29.0.1. L'errore si verificava prima che CasaOS potesse completare l'installazione, perché il repository Noble di Docker non conteneva più la versione del pacchetto prevista dallo script storico.
Perché Ubuntu 24.04 non riusciva a trovare Docker CE 24.0.7
Lo script di installazione storico chiedeva di fatto al repository Ubuntu 24.04 di Docker una versione del pacchetto che non era più disponibile. Eseguendo:
apt-cache madison docker-ceha confermato che non esisteva alcuna voce corrispondente alla versione 24.0.7.
Il membro della community gelbuilding lo ha descritto correttamente come una mancata sincronizzazione temporale tra il programma di installazione e il repository dei pacchetti Docker. All'epoca, in attesa dell'aggiornamento del programma di installazione, veniva suggerito di usare una distribuzione supportata più datata, come Ubuntu 22.04 o Debian 12, come soluzione con il minor numero di complicazioni.
Cosa ha modificato CasaOS dopo il problema del 2025
La successiva discussione su GitHub di CasaOS relativa allo stesso problema di compatibilità con Docker riportava che lo script di installazione era stato corretto. Il comportamento aggiornato è stato descritto come segue:
- installare la versione più recente disponibile di Docker Engine invece di Docker 24.0.7;
- applicare una deroga di compatibilità con l'API di Docker per le versioni moderne di Docker;
- consentire ai servizi CasaOS e alla gestione integrata delle app di funzionare con versioni più recenti di Docker.
Il codice sorgente dell’installer aggiornato definisce inoltre una versione principale minima di Docker invece di imporre Docker CE 24.0.7. Puoi consultare lo script dell’installer di CasaOS.
Metodo di installazione aggiornato di CasaOS
Il repository aggiornato di CasaOS documenta ancora l’installer standard su una sola riga:
curl -fsSL https://get.casaos.io | sudo bashoppure:
wget -qO- https://get.casaos.io | sudo bashConsulta le istruzioni per l’installazione di CasaOS su GitHub.
Non eseguire oggi il downgrade di Docker a 24.0.7 come prima soluzione
Quando è stato creato il post della community, cercare un modo per ripristinare Docker 24.0.7 era comprensibile, perché l’installer richiedeva esplicitamente quella versione. Ora che l’installer è stato aggiornato, forzare nuovamente un pacchetto Docker obsoleto su Ubuntu 24.04 è solitamente il passo iniziale sbagliato.
Il downgrade di Docker può creare altri problemi di compatibilità e sicurezza, mentre la combinazione di versioni di Ubuntu o repository di pacchetti diversi solo per ripristinare una versione storica può lasciare l’host in uno stato dei pacchetti non supportato.
Per un’installazione aggiornata, inizia dall’installer CasaOS attuale e dallo stato attuale del repository Docker.
Come verificare se stai ancora utilizzando un installer obsoleto
Se continui a vedere:
Ricerca nel repository della VERSIONE «24.0.7»con ogni probabilità stai eseguendo un installer memorizzato nella cache, copiato, modificato o di terze parti, invece dello script aggiornato.
Verifica da dove proviene lo script. Evita di copiare un casaos-install.sh da un allegato del forum o da un repository di automazione obsoleto, quando è disponibile lo script upstream aggiornato.
Cosa succede se Docker è già installato?
L’autore originale aveva già installato Docker 29.0.1. Un installer aggiornato dovrebbe rilevare e utilizzare un’installazione di Docker compatibile, invece di richiedere il pacchetto obsoleto della discussione originale.
Prima di installare CasaOS, verifica:
docker --version
docker version
systemctl status dockerSe Docker funziona correttamente ma l’installazione attuale di CasaOS continua a non riuscire, acquisisci l’output completo dell’installer prima di rimuovere Docker. Il problema attuale potrebbe avere una causa diversa dal bug storico della versione 24.0.7.
Ubuntu 24.04 non è uguale all’host più conservativo consigliato da CasaOS
L’attuale repository di CasaOS indica Debian 12 come sistema operativo testato e consigliato e, separatamente, elenca altre piattaforme supportate o testate dalla community. Le installazioni Ubuntu possono funzionare, ma il livello preciso di test varia a seconda della versione.
Se stai configurando un home server di produzione e vuoi ridurre al minimo il lavoro di risoluzione dei problemi, usa un sistema operativo host esplicitamente indicato da CasaOS come testato o consigliato, invece di presumere che ogni nuova versione di Ubuntu venga validata immediatamente dall’installer.
Non disabilitare la verifica TLS per risolvere un errore non correlato dell’installer
CasaOS ha avuto incidenti storici separati che riguardavano il certificato su get.casaos.io. Un problema con il certificato TLS è diverso dal problema del pacchetto Docker 24.0.7.
Se curl segnala un errore di verifica del certificato, non aggiungere automaticamente -k o disabilitare globalmente la verifica dei certificati. Questo modifica il modello di attendibilità del download dell’installer e non dovrebbe essere associato alla risoluzione dei problemi dei pacchetti Docker.
Procedura attuale per la risoluzione dei problemi
- Conferma il sistema operativo e l’architettura dell’host.
- Esegui
docker --versione conferma che Docker funzioni correttamente se è già installato. - Usa l’installer attuale da
get.casaos.io, non una vecchia copia locale. - Se l’output richiede ancora esplicitamente Docker 24.0.7, interrompi la procedura e verifica il codice sorgente dello script.
- Non aggiungere vecchi repository Ubuntu solo per recuperare Docker 24.0.7.
- Non eseguire il downgrade di Docker finché non hai confermato un requisito di compatibilità attuale.
- Salva il log completo dell’installer se lo script attuale non riesce per un altro motivo.
Domande frequenti sull’installer di CasaOS Docker 24.0.7
Perché CasaOS ha indicato che Docker CE 24.0.7 non era stato trovato?
L’installer storico cercava esplicitamente quella versione nel repository Docker. A novembre 2025, il repository Ubuntu 24.04 Noble non la offriva più, causando l’interruzione dell’installazione.
L’installer attuale di CasaOS richiede ancora Docker 24.0.7?
Il codice sorgente dell’installer upstream attuale non mostra più il vecchio requisito fisso di Docker 24.0.7 e i manutentori di CasaOS hanno riferito nel dicembre 2025 che l’installer era stato aggiornato per usare la versione più recente disponibile di Docker Engine, con gestione della compatibilità.
Devo installare manualmente Docker 24.0.7?
Non come normale soluzione attuale. Quello era un requisito storico del pacchetto. Inizia con l’installer attuale e i pacchetti Docker correnti.
CasaOS può funzionare con versioni più recenti di Docker?
Il lavoro di installazione e compatibilità svolto dopo l’incidente del 2025 era specificamente finalizzato a consentire a CasaOS di funzionare con le versioni moderne di Docker. Se una versione attuale non funziona, diagnostica l’errore preciso dell’API o del servizio invece di presumere che tutte le versioni moderne di Docker non siano supportate.
