O CasaOS e o ZimaOS são sistemas operativos diferentes, pelo que a passagem entre ambos é uma migração e não uma atualização no local. É possível transferir ficheiros, dados padrão das aplicações e muitas configurações Docker Compose, mas os utilizadores do sistema, as definições de rede, as montagens de armazenamento, as partilhas e os contentores profundamente personalizados podem ter de ser recriados manualmente.
A resposta também mudou depois de a pergunta da comunidade ter sido publicada pela primeira vez. Em julho de 2025, a resposta oficial descrevia a cópia de ficheiros através de uma LAN e a reinstalação manual das aplicações. Em setembro de 2025, a IceWhale publicou um guia de migração. O guia atual, atualizado em setembro de 2026, adiciona a ferramenta CTOZ para transferir muitos contentores da App Store do CasaOS e os respetivos dados.
CasaOS para ZimaOS é uma migração, não uma atualização no local
Uma atualização no local substituiria o CasaOS, preservando automaticamente a configuração do sistema. Esse não é o modelo descrito pela equipa do ZimaOS. A instalação do ZimaOS cria um ambiente de sistema operativo diferente, pelo que o plano seguro consiste em fazer o inventário, criar uma cópia de segurança, instalar, migrar, verificar e só depois desativar o ambiente original.
Não substitua a única cópia do seu sistema CasaOS até que os ficheiros pessoais, os dados das aplicações, as definições Compose, as credenciais e as notas de configuração tenham sido copiados para um armazenamento verificado.
Registe os caminhos e as definições das aplicações antes de começar
A primeira resposta oficial recomendava abrir o painel de definições de cada aplicação e registar os caminhos das pastas existentes. Isto continua a ser útil mesmo quando está disponível uma ferramenta de migração automática, porque um contentor pode arrancar com sucesso enquanto aponta para o diretório de dados errado.
Para cada aplicação, registe:
- Imagem e versão do contentor.
- Caminhos dos volumes do anfitrião e do contentor.
- Portas e modo de rede.
- Variáveis de ambiente e IDs de utilizador/grupo.
- Pastas AppData, de bases de dados, multimédia e de configuração.
- Quaisquer redes Docker ou dispositivos criados manualmente.
Migração quando o CasaOS e o ZimaOS podem ser executados ao mesmo tempo
A opção mais simples é manter a origem CasaOS e o destino ZimaOS disponíveis na mesma LAN. Partilhe as pastas CasaOS necessárias através de SMB, monte essa partilha nos Ficheiros do ZimaOS e copie ou migre os dados para o armazenamento de destino.
Para aplicações instaladas através da App Store do CasaOS, o guia de migração do CasaOS para o ZimaOS atual recomenda a ferramenta CTOZ, desenvolvida pela comunidade. O CTOZ pode transferir o diretório AppData do CasaOS e o YAML do Docker Compose correspondente e, em seguida, reinstalar as aplicações compatíveis no ZimaOS.
O que o CTOZ migra
- AppData associados às aplicações CasaOS compatíveis.
- O YAML do Docker Compose utilizado para recriar os contentores.
- Dados e configuração padrão das aplicações abrangidos por essas pastas mapeadas.
O que o CTOZ não migra automaticamente
- Utilizadores do CasaOS e definições ao nível do sistema.
- Configuração da rede, montagens de armazenamento e configuração de partilhas.
- Contentores não normalizados implementados fora da App Store do CasaOS.
- Alterações personalizadas no anfitrião que não estejam representadas nos ficheiros AppData ou Compose.
Migração quando só tem um servidor
O tópico de 2025 destacou a topologia mais difícil: o CasaOS e o ZimaOS não podem ser executados lado a lado no mesmo servidor durante uma reinstalação bare-metal. A equipa sugeriu copiar primeiro os ficheiros para um PC Windows e repô-los depois de o ZimaOS estar instalado, tratando cada aplicação e os respetivos dados individualmente.
O guia atual também descreve a exportação/importação através do CTOZ para situações offline ou autónomas. Isto pode reduzir a reconstrução manual dos contentores, mas não elimina a necessidade de um armazenamento de cópias de segurança independente. Antes de substituir o CasaOS, exporte os materiais das aplicações compatíveis e copie-os — juntamente com os ficheiros pessoais e um registo separado das definições do sistema — para um PC Windows, um disco externo, um NAS ou outro destino verificado.
Ordem de migração recomendada do CasaOS para o ZimaOS
- Fazer o inventário: Liste ficheiros, partilhas, aplicações, volumes, portas, credenciais, bases de dados, utilizadores e contentores personalizados.
- Fazer uma cópia de segurança: Crie pelo menos uma cópia verificada fora do disco do sistema CasaOS. As bases de dados podem exigir exportações específicas da aplicação, além da cópia dos ficheiros.
- Exportar aplicações compatíveis: Utilize o fluxo de trabalho atual do CTOZ, quando aplicável, e guarde o YAML do Docker Compose.
- Instalar o ZimaOS: Efetue a instalação limpa apenas depois de conseguir abrir a cópia de segurança a partir de outro dispositivo.
- Restaurar ficheiros: Copie os ficheiros pessoais e os dados das aplicações para as localizações de armazenamento pretendidas no ZimaOS.
- Importar ou reinstalar aplicações: Utilize o CTOZ ou a importação manual de Compose do ZimaOS e, em seguida, corrija as portas e os caminhos dos volumes, conforme necessário.
- Recriar as definições do sistema: Configure utilizadores, partilhas, rede, montagens e permissões no ZimaOS.
- Validar: Abra todas as aplicações, confirme os respetivos dados, teste as operações de escrita e as permissões e verifique o acesso remoto antes de eliminar a cópia de segurança.
Quando uma aplicação não é reinstalada automaticamente
A documentação atual do ZimaOS indica que o CTOZ transfere o AppData mesmo quando a instalação automatizada do contentor falha. Se uma pasta de destino já tiver o mesmo nome, a ferramenta pode acrescentar um número em vez de a substituir. O YAML do Compose exportado pode então ser importado manualmente através da App Store do ZimaOS.
Após qualquer migração automatizada, verifique as definições da aplicação e confirme que os caminhos dos volumes apontam para as pastas transferidas. Um contentor em execução não é prova suficiente de que a respetiva base de dados, biblioteca multimédia ou configuração foi restaurada corretamente.
Tratar Manualmente os Contentores CLI e Não Normalizados
Os contentores criados fora da App Store do CasaOS estão fora do âmbito automático documentado do CTOZ. Localize os respetivos bind mounts, volumes nomeados, AppData, ficheiros Compose, variáveis de ambiente e segredos. Depois de instalar o ZimaOS, implemente novamente a imagem ou o projeto Compose e associe os dados restaurados utilizando os caminhos de anfitrião corretos do ZimaOS.
O projeto CTOZ de código aberto no GitHub disponibiliza o código-fonte da ferramenta e as informações de instalação atuais referidas no guia oficial.
Perguntas frequentes sobre a migração do CasaOS para o ZimaOS
É possível atualizar diretamente o CasaOS para o ZimaOS?
Não. A equipa do ZimaOS descreveu-os como sistemas operativos diferentes. Planeie uma migração com cópias de segurança e uma instalação limpa do ZimaOS, em vez de uma atualização no local.
As aplicações do CasaOS e os respetivos dados podem ser movidos para o ZimaOS?
Muitos contentores padrão da App Store do CasaOS podem ser migrados com o CTOZ, incluindo os respetivos AppData e YAML do Docker Compose. Os contentores não suportados ou personalizados exigem uma cópia de segurança e uma nova implementação manuais.
Preciso de dois servidores?
Dois sistemas em execução simultânea tornam mais fácil a transferência pela LAN e a migração online com o CTOZ, mas a documentação atual também descreve a exportação/importação para migrações offline ou autónomas. Uma migração com um único servidor continua a exigir outro local seguro para guardar a cópia de segurança enquanto o CasaOS é substituído.
Um PC Windows pode servir como destino temporário da migração?
Sim. A resposta oficial da comunidade sugeriu copiar os ficheiros para o Windows antes de instalar o ZimaOS e copiá-los novamente depois. Preserve os dados das aplicações, as definições do Compose e os registos de configuração, além dos ficheiros pessoais.
Os utilizadores, pontos de montagem e definições de rede do CasaOS serão transferidos automaticamente?
Não. As orientações atuais indicam que os utilizadores do sistema, a configuração de rede, os pontos de montagem de armazenamento e as partilhas têm de ser recriados ou verificados manualmente no ZimaOS.
Que versão do CasaOS requer o CTOZ?
O guia oficial atual especifica o CasaOS 0.4.4 ou posterior, porque o CTOZ depende das configurações Docker Compose padronizadas utilizadas pelas versões mais recentes do CasaOS.
