Alguns instaladores Docker de fornecedores partem do princípio de que podem criar diretórios de aplicações diretamente no sistema de ficheiros raiz do Linux. Isso entra em conflito com o design do ZimaOS, semelhante ao de um dispositivo, quando um instalador exige um caminho no anfitrião como /app.
Este tópico de janeiro de 2026 acabou por chegar a uma solução melhor do que tornar o sistema de ficheiros raiz do ZimaOS gravável: configurar o ONLYOFFICE Workspace para utilizar armazenamento persistente em /media e selecionar explicitamente o tipo de instalação Community.
Não torne a raiz do ZimaOS gravável apenas para satisfazer um instalador
A implementação original consistia em vários contentores para serviços de base de dados, pesquisa, documentos, correio, comunicações e gestão. O instalador do fornecedor esperava /app, enquanto o utilizador queria que os dados reais fossem armazenados numa unidade de dados ZimaOS de grande capacidade.
A comunidade orientou corretamente a discussão para longe da modificação permanente do sistema de ficheiros base do ZimaOS. As atualizações de um sistema operativo semelhante a um dispositivo podem substituir ou invalidar alterações não suportadas feitas no sistema de ficheiros raiz.
O instalador do fornecedor tinha um diretório base configurável
Depois de inspecionar os scripts do instalador, o utilizador descobriu que a localização de armazenamento não estava, na realidade, codificada de forma fixa. O diretório base podia ser alterado do caminho predefinido ao nível da raiz para uma localização persistente na unidade de dados do ZimaOS.
Essa é uma arquitetura mais segura, porque os contentores e os dados das aplicações permanecem num armazenamento gravável, enquanto a imagem do sistema ZimaOS continua a ser gerida pelo sistema operativo.
Selecione explicitamente o tipo de instalação Community
Mais tarde, o utilizador comunicou um segundo problema: depois de alterar o diretório base, o instalador podia recuar para a edição Enterprise. Após trabalharem com o fornecedor do software, confirmaram que a implementação Community necessitava da seleção adequada do tipo de instalação.
As instruções atuais do ONLYOFFICE continuam a apresentar tipos de instalação Community e Enterprise separados. Antes de alterar um script antigo descarregado, confirme quais os parâmetros do script que selecionam o Workspace Community no instalador atual.
Utilize o script atual do ONLYOFFICE, não o nome de ficheiro histórico do fórum
A resposta no fórum de 2026 referia um nome de ficheiro de instalador mais antigo. As instruções atuais do ONLYOFFICE Workspace publicam agora workspace-install.sh para implementações Docker e documentam separadamente os parâmetros suportados.
O processo atual do projeto upstream e os requisitos do sistema estão descritos no fluxo de instalação Docker mantido do Workspace Community.
O Docker Compose continua a ser uma alternativa mais transparente
A discussão da comunidade também considerou implementar a pilha a partir do Compose, em vez de depender de um script de instalação extenso. Essa abordagem facilita a revisão das edições das imagens, dos caminhos dos volumes, das redes e do armazenamento persistente antes da implementação.
Se importar uma pilha com vários contentores para o ZimaOS atual, as definições de execução padrão devem ficar no Docker Compose. A explicação atual sobre como o ZimaOS gere a configuração do Docker Compose ajuda a manter os caminhos de armazenamento do fornecedor separados dos metadados das aplicações do ZimaOS.
FAQ sobre o ONLYOFFICE no ZimaOS
Tenho de tornar o sistema de ficheiros raiz do ZimaOS gravável?
Não. Nenhuma solução do tópico final exigia isso. A abordagem melhor consistia em colocar o diretório base do fornecedor num armazenamento persistente gravável.
O /app era realmente obrigatório?
O fornecedor do utilizador confirmou, em última instância, que o diretório base do instalador podia ser alterado, pelo que o anfitrião não precisava de armazenar a aplicação no caminho /app ao nível da raiz.
Porque apareceu a edição errada?
O utilizador descobriu que a alteração do diretório base revelava um comportamento do instalador que predefinia a edição Enterprise. Comunicou que selecionar explicitamente o tipo de instalação Community resolveu essa questão.
Devo copiar exatamente os comandos do fórum de 2026?
Não. O nome de ficheiro e os parâmetros atuais do instalador do ONLYOFFICE devem ser verificados nas instruções mantidas pelo projeto antes da implementação.
