Se o instalador do CasaOS parar no Ubuntu 24.04 com ERRO: '24.0.7' não encontrado nos resultados de apt-cache madison, o erro resulta de uma incompatibilidade histórica entre o instalador e a versão do Docker, e não da ausência de um pacote do Ubuntu que deva ser forçado a voltar a instalar no sistema. O relatório da IceWhale Community de novembro de 2025 reproduziu a falha numa máquina Ubuntu 24.04 LTS nova, apesar de o Docker 29.0.1 já estar instalado e a funcionar.
A fronteira temporal importante é que este erro específico do instalador foi posteriormente corrigido. Em dezembro de 2025, os responsáveis pelo CasaOS informaram que o script de instalação tinha sido atualizado para instalar a versão mais recente disponível do Docker Engine, em vez de fixar a versão 24.0.7, e para aplicar um tratamento de compatibilidade da API do Docker para versões mais recentes. O script de instalação atual do CasaOS já não expõe o antigo valor codificado 24.0.7 dependência observada no tópico original.
Qual era o aspeto do erro do instalador original do CasaOS
O autor da comunidade instalou o CasaOS com:
curl -fsSL https://get.casaos.io | sudo bashe também tentou:
export INSTALL_DOCKER=falsemas o instalador continuou a entrar na fase das dependências do Docker e procurou uma única versão exata no repositório APT do Docker:
INFO: A procurar no repositório a VERSION '24.0.7'
apt-cache madison docker-ce | grep '24.0.7'
ERRO: '24.0.7' não encontrado nos resultados de apt-cache madisonO anfitrião já tinha o Docker Engine 29.0.1. A falha ocorreu antes de o CasaOS conseguir concluir a instalação, porque o repositório Noble do Docker já não continha a versão do pacote esperada pelo script histórico.
Porque é que o Ubuntu 24.04 não conseguiu encontrar o Docker CE 24.0.7
O instalador histórico estava, na prática, a pedir ao repositório do Ubuntu 24.04 do Docker uma versão de pacote que já não estava disponível. Executar:
apt-cache madison docker-ceconfirmou que não existia nenhuma entrada correspondente à versão 24.0.7.
O membro da comunidade gelbuilding descreveu corretamente esta situação como uma incompatibilidade temporal entre o instalador e o repositório de pacotes do Docker. Na altura, enquanto se aguardava a atualização do instalador, foi sugerido utilizar uma distribuição mais antiga suportada, como o Ubuntu 22.04 ou o Debian 12, como solução com menos complicações.
O que o CasaOS alterou após a falha de 2025
A discussão posterior no GitHub do CasaOS sobre o mesmo incidente de compatibilidade do Docker relatou que o script de instalação tinha sido corrigido. O comportamento atualizado foi descrito da seguinte forma:
- instalar a versão mais recente disponível do Docker Engine em vez da versão 24.0.7 do Docker;
- aplicar uma substituição de compatibilidade da API do Docker para versões modernas do Docker;
- permitir que os serviços do CasaOS e a gestão integrada de aplicações funcionem com versões mais recentes do Docker.
A origem do instalador atual também define uma versão principal mínima do Docker, em vez de fixar o Docker CE 24.0.7. Pode consultar o script do instalador do CasaOS atual.
Método atual de instalação do CasaOS
O repositório atual do CasaOS continua a documentar o instalador padrão de uma só linha:
curl -fsSL https://get.casaos.io | sudo bashou:
wget -qO- https://get.casaos.io | sudo bashConsulte as instruções de instalação atuais do CasaOS no GitHub.
Não faça downgrade do Docker para a versão 24.0.7 como primeira solução hoje
Quando a publicação da comunidade foi criada, era compreensível procurar uma forma de restaurar o Docker 24.0.7, porque o instalador exigia explicitamente essa versão. Depois de o próprio instalador ter sido atualizado, forçar a instalação de um pacote obsoleto do Docker no Ubuntu 24.04 é normalmente o passo inicial errado.
Fazer o downgrade do Docker pode criar outros problemas de compatibilidade e segurança, e misturar versões do Ubuntu ou repositórios de pacotes apenas para recuperar uma versão histórica pode deixar o anfitrião num estado de pacotes não suportado.
Para uma instalação atual, comece pelo instalador atual do CasaOS e pelo estado atual do repositório do Docker.
Como verificar se ainda está a utilizar um instalador antigo
Se ainda vir:
Procurar no repositório por VERSION '24.0.7'é quase certo que está a executar um instalador antigo, colocado em cache, replicado, modificado ou de terceiros, em vez do script atual.
Verifique a origem do script. Evite copiar um script antigo casaos-install.sh a partir de um anexo de fórum ou de um repositório de automação desatualizado, quando o script atual do projeto original está disponível.
E se o Docker já estiver instalado?
O autor original já tinha o Docker 29.0.1 instalado. Um instalador atual deve detetar e funcionar com uma instalação aceitável do Docker, em vez de exigir o pacote obsoleto mencionado na publicação original.
Antes de instalar o CasaOS, verifique:
docker --version
docker version
systemctl status dockerSe o Docker estiver operacional, mas a instalação atual do CasaOS continuar a falhar, guarde todo o resultado do instalador antes de remover o Docker. A falha atual pode ter uma causa diferente da do erro histórico da versão 24.0.7.
Ubuntu 24.04 não é o mesmo que o anfitrião mais conservador recomendado pelo CasaOS
O repositório atual do CasaOS indica o Debian 12 como sistema operativo testado e recomendado, e lista separadamente outras plataformas suportadas ou testadas pela comunidade. As instalações Ubuntu podem funcionar, mas o nível exato de testes varia consoante a versão.
Se estiver a criar um servidor doméstico de produção e quiser minimizar o trabalho de resolução de problemas, utilize um sistema operativo anfitrião explicitamente indicado pelo CasaOS como testado/recomendado, em vez de presumir que todas as novas versões do Ubuntu recebem validação imediata do instalador.
Não desative a verificação TLS para resolver um erro não relacionado do instalador
O CasaOS teve incidentes históricos separados relacionados com o certificado em get.casaos.io. Um problema com o certificado TLS é diferente do problema do pacote Docker 24.0.7.
Se curl indicar um erro de verificação de certificado, não adicione automaticamente -k ou desative globalmente a verificação de certificados. Isso altera o modelo de confiança da transferência do instalador e não deve ser misturado com a resolução de problemas dos pacotes Docker.
Fluxo de trabalho atual para resolução de problemas
- Confirme o sistema operativo anfitrião e a arquitetura.
- Execute
docker --versione confirme que o Docker está a funcionar corretamente, caso já esteja instalado. - Utilize o instalador atual a partir de
get.casaos.io, e não uma cópia local antiga. - Se o resultado continuar a solicitar explicitamente o Docker 24.0.7, pare e verifique a origem do script.
- Não adicione repositórios Ubuntu antigos apenas para recuperar o Docker 24.0.7.
- Não faça downgrade do Docker até confirmar que existe um requisito de compatibilidade atual.
- Guarde o registo completo do instalador se o script atual falhar por outro motivo.
Perguntas frequentes sobre o instalador do CasaOS Docker 24.0.7
Porque é que o CasaOS indicava que o Docker CE 24.0.7 não foi encontrado?
O instalador histórico procurava explicitamente essa versão no repositório do Docker. Em novembro de 2025, o repositório Ubuntu 24.04 Noble já não a disponibilizava, pelo que a instalação deixou de funcionar.
O instalador atual do CasaOS ainda requer o Docker 24.0.7?
O código-fonte do instalador atual a montante já não apresenta o antigo requisito fixo do Docker 24.0.7, e os responsáveis pela manutenção do CasaOS comunicaram, em dezembro de 2025, que o instalador tinha sido atualizado para utilizar a versão mais recente disponível do Docker Engine, com mecanismos de compatibilidade.
Devo instalar manualmente o Docker 24.0.7?
Não como solução normal atual. Esse era um requisito histórico do pacote. Comece pelo instalador atual e pelos pacotes Docker atuais.
O CasaOS funciona com versões mais recentes do Docker?
O trabalho do instalador e de compatibilidade realizado após o incidente de 2025 destinava-se especificamente a permitir que o CasaOS funcionasse com versões modernas do Docker. Se uma versão atual falhar, diagnostique o erro exato da API ou do serviço em vez de presumir que todas as versões modernas do Docker não são suportadas.
