Em janeiro de 2026, os utilizadores que instalaram uma aplicação a partir da ZimaOS App Store podiam alterar definições expostas, como portas, variáveis de ambiente e volumes, mas não tinham o mesmo controlo ao nível do Compose que teriam com uma stack da sua própria gestão. Isto tornou-se um problema para definições avançadas, como etiquetas do Traefik, redes partilhadas, middleware ou DNS específico de cada contentor.
A atualização importante é que o roteiro referido no tópico já não está apenas no futuro. A IceWhale afirmou que estava a refatorar a App Store para adicionar a edição de YAML do Docker Compose, e a ZimaOS 1.7.0 disponibilizou posteriormente suporte nativo para YAML.
Porque era difícil editar aplicações da App Store no início de 2026
A explicação dada pela comunidade era que as aplicações instaladas a partir da loja eram geridas pela ZimaOS. A edição do Compose gerado fora desse processo de gestão podia ser substituída por novas implementações ou atualizações.
Para utilizadores avançados, a solução prática na altura era instalar o serviço como Custom Compose, manter as mesmas pastas persistentes de AppData e gerir a stack do Compose autonomamente com uma ferramenta como o Dockge ou o Portainer.
As definições avançadas de proxy inverso requerem controlo ao nível do Compose
O utilizador original queria especificamente etiquetas do Traefik e uma forma de obrigar determinados contentores a utilizarem o DNS da Cloudflare em vez do Pi-hole. Estas são preocupações normais do Docker Compose, e não simples definições do nome da aplicação ou das portas.
As especificações atuais das aplicações da App Store da ZimaOS tornam esta separação explícita: a configuração padrão do runtime pertence ao Docker Compose, enquanto os metadados específicos da loja da ZimaOS pertencem ao x-casaos.
A IceWhale confirmou que estava previsto um editor de YAML
Zima-Jerry respondeu que a equipa estava a refatorar a App Store e a experiência de instalação para permitir que um processo de instalação simples coexistisse com a edição avançada de YAML do Docker Compose.
Essa resposta oficial é mais esclarecedora do que a suposição anterior da comunidade de que as aplicações da loja nunca poderiam ser editadas diretamente.
A ZimaOS 1.7.0 adicionou suporte nativo para YAML
Em julho de 2026, a ZimaOS App Store 2.0 disponibilizou uma reformulação da gestão de aplicações e suporte nativo para YAML, permitindo uma configuração mais flexível das aplicações. A ZimaOS atual também centraliza o estado, as atualizações e as definições comuns das aplicações instaladas na página de gestão de aplicações.
A visão geral atual da App Store mostra como as aplicações instaladas são agora geridas através da interface de aplicações reformulada da ZimaOS.
O YAML nativo não significa que todas as stacks externas sejam geridas automaticamente
O novo editor melhora o controlo sobre as aplicações geridas pela ZimaOS, mas não deve ser confundido com a posse ou gestão completa de quaisquer stacks do Compose iniciadas fora do sistema de aplicações da ZimaOS. Os relatórios atuais da versão 1.7.x continuam a distinguir os grupos do Compose iniciados manualmente das aplicações que a ZimaOS gere diretamente.
Preserve o AppData ao alterar o modelo de gestão
Se decidir mover deliberadamente uma aplicação de um pacote gerido da loja para uma stack do Compose gerida por si, os dados importantes encontram-se normalmente nas pastas persistentes do anfitrião. Faça primeiro uma cópia de segurança e, em seguida, reproduza os mesmos mapeamentos de volumes, portas, valores de ambiente e dependências da base de dados antes de remover o contentor antigo.
Não parta do princípio de que recriar um contentor migra automaticamente todas as definições ou todos os segredos específicos da ZimaOS.
Perguntas frequentes sobre a edição do YAML de aplicações da ZimaOS
A edição direta do Compose estava disponível quando o tópico foi publicado?
Não da forma pretendida pelo utilizador. A solução sugerida pela comunidade era utilizar Custom Compose, enquanto a IceWhale afirmava que a edição direta de YAML estava em desenvolvimento.
A ZimaOS acabou por adicionar a edição nativa de YAML?
Sim. A ZimaOS 1.7.0 anunciou suporte nativo para YAML como parte da reformulação da App Store 2.0.
Devo continuar a utilizar o Dockge?
Pode continuar a fazer sentido quando pretende deliberadamente gerir uma stack independente do Compose, em vez de deixar a ZimaOS gerir a aplicação.
Posso manter os dados existentes da aplicação ao mudar para Custom Compose?
Muitas vezes, sim, desde que as pastas persistentes do anfitrião sejam preservadas e remapeadas corretamente. No entanto, faça uma cópia de segurança dos dados e registe primeiro as definições originais do contentor.
