Solução da comunidade

Instalar o Coolify no ZimaOS: o que falta no guia do CasaOS

A January 2025 CasaOS tutorial later became a ZimaOS troubleshooting discussion when a user hit Coolify SSH-key requirements on the read-only system.

O antigo tutorial do CasaOS para o Coolify continua a ser útil como referência para o projeto, mas não é uma receita de instalação direta para o ZimaOS atual. A principal diferença é que o Coolify espera ter acesso por chave SSH ao servidor que gere, enquanto o ZimaOS protege partes do seu sistema base como só de leitura.

No seguimento de 2026 do tópico do fórum, o bloqueio era precisamente este: o Coolify pedia que a sua chave pública fosse copiada para ~/.ssh/authorized_keys, mas o utilizador não conseguia encontrar um caminho SSH normal e gravável para o root. Considere isto um problema de integração com a plataforma, não uma prova de que o próprio Coolify está avariado.

Porque é que o guia do CasaOS não se aplica diretamente ao ZimaOS

A documentação atual do Coolify indica que um servidor autoalojado precisa de acesso SSH e que a chave pública utilizada pelo Coolify deve ser autorizada para a conta que este gere. O instalador também cria dados em /data/coolify e espera gerir o Docker no anfitrião. Estas premissas são normais num servidor Linux convencional.

O ZimaOS, no entanto, é um sistema operativo NAS ao estilo de um appliance. O guia oficial de SSH do ZimaOS mostra como ativar o SSH a partir do Modo de Programador, mas não garante que todos os caminhos Linux convencionais sejam graváveis ou persistentes entre atualizações do sistema.

O que o Coolify exige atualmente

O atual guia de instalação do Coolify indica um servidor Linux de 64 bits com acesso SSH, suporte para Docker, pelo menos 2 núcleos de CPU, 2 GB de RAM e 30 GB de armazenamento livre. Recomenda também um servidor novo para reduzir conflitos com serviços existentes.

O Coolify utiliza SSH mesmo quando gere a mesma máquina onde está a ser executado. A sua documentação de configuração do OpenSSH espera especificamente uma autenticação baseada em chaves. É por isso que importar simplesmente uma definição de aplicação do CasaOS não elimina o requisito de SSH no anfitrião.

Caminhos de implementação mais seguros num servidor doméstico ZimaOS

Se pretende utilizar o Coolify principalmente para implementações de aplicações, a opção mais limpa é executá-lo num ambiente Linux que corresponda às premissas suportadas pelo Coolify, como um servidor ou uma máquina virtual Debian/Ubuntu dedicada, e deixar o ZimaOS continuar a gerir o armazenamento NAS e os restantes serviços. Desta forma, as alterações ao nível do anfitrião efetuadas pelo Coolify ficam afastadas do sistema base protegido do ZimaOS.

Se ainda assim quiser experimentar diretamente no ZimaOS, faça primeiro uma cópia de segurança dos dados das aplicações e confirme exatamente onde irão persistir as chaves SSH e o estado do Coolify. Um repositório comunitário de aprendizagem documenta o trabalho específico para o ZimaOS, mas deve ser encarado como experimentação da comunidade e não como um caminho de instalação suportado pela IceWhale: repositório comunitário de aprendizagem sobre o Coolify no ZimaOS.

Para utilizadores que estejam a criar um pequeno anfitrião de implementação sempre ligado, um servidor doméstico compacto pode fornecer a camada de hardware x86, mas a escolha do sistema operativo deve continuar a seguir o software que pretende executar.

Em suma

O tópico do fórum não comprova a existência de um método de instalação do Coolify no ZimaOS com um clique. Comprova precisamente o contrário: a receita do CasaOS esbarra num limite de persistência do SSH no ZimaOS. Utilize os requisitos atuais do Coolify como referência principal e isole o Coolify num ambiente Linux convencional quando pretender o caminho de atualização e recuperação mais previsível.