Solução da comunidade

O PhotoPrism não inicia no ZimaOS: corrija o mapeamento dos originais e do armazenamento

A January 2026 PhotoPrism install failed repeatedly. Logs pointed to a .ppstorage file under the Originals path; simply deleting it did not last, but changing the ZimaOS Originals volume mapping allowed PhotoPrism to start.

A solução final neste tópico não foi “eliminar .ppstorage sempre que isso acontecesse”. O ficheiro voltava a aparecer porque a estrutura do volume subjacente continuava incorreta. O diagnóstico útil veio dos registos, e a alteração duradoura consistiu em corrigir o diretório do anfitrião que estava associado ao caminho Originals do PhotoPrism.

Ecrã da aplicação PhotoPrism e registos de uma instalação no ZimaOS que não iniciou
O autor da publicação original partilhou o estado do PhotoPrism que estava a falhar antes de corrigir os mapeamentos de armazenamento.
Definições da aplicação PhotoPrism no ZimaOS que mostram a configuração original dos volumes
As definições da aplicação foram comparadas com um modelo funcional da comunidade para identificar o problema no caminho Originals.
Notificação do ZimaOS a indicar que a aplicação PhotoPrism não podia iniciar com a estrutura de armazenamento original
A notificação foi acompanhada por registos que apontavam para um conflito no caminho de armazenamento/Originals.
Mapeamento corrigido dos Originals do PhotoPrism que permitiu iniciar a aplicação no ZimaOS
A captura de ecrã final da comunidade mostrava o mapeamento Originals alterado que permitiu iniciar o PhotoPrism.

A Mensagem do Registo Era uma Pista, Não a Solução Completa

Uma resposta identificou um marcador .ppstorage dentro de /DATA/Gallery e sugeriu eliminá-lo. O utilizador fê-lo, mas o PhotoPrism recriou os ficheiros e continuou a falhar. Isso demonstrou que era necessário corrigir a relação entre os caminhos, e não apenas eliminar o ficheiro.

O PhotoPrism Separa Originals de Storage

A página oficial sobre pastas de armazenamento do PhotoPrism explica que a pasta storage contém dados de configuração, cache, cópias de segurança, miniaturas e ficheiros sidecar, e que normalmente não deve ser configurada dentro de Originals, exceto quando utiliza uma estrutura com nomes ocultos compatível com o PhotoPrism. Esta regra do projeto explica por que razão associar o armazenamento da aplicação à árvore de fotografias Originals pode causar problemas.

A página sobre a primeira aplicação Docker explica o modelo de caminho do anfitrião/caminho do contentor no ZimaOS, enquanto os requisitos da App Store do ZimaOS fornecem o contexto atual ao nível dos pacotes quando existem vários modelos ou conjuntos de dependências.

Consulte os Registos Antes de Alterar Bases de Dados ou Permissões

A resolução oficial de problemas do PhotoPrism Docker recomenda verificar os registos do Docker e menciona especificamente erros relacionados com disco, permissões, rotas e armazenamento. Neste caso, o registo forneceu informação suficiente para evitar reconstruir aleatoriamente o MariaDB, alterar portas ou reinstalar todo o sistema operativo.

O Que a Alteração Funcional da Comunidade Comprovou

O utilizador comparou o modelo BigBear com o mapeamento da App Store do ZimaOS, alterou a ligação Originals e o PhotoPrism iniciou. Isto confirma que o mapeamento do armazenamento foi determinante para esta instalação; não comprova que todos os pacotes atuais do PhotoPrism utilizem exatamente o mesmo caminho no anfitrião.

Em Resumo

Se o PhotoPrism for instalado, mas terminar imediatamente, leia os registos antes de alterar tudo ao mesmo tempo. Neste caso da comunidade, o sintoma repetido relacionado com .ppstorage apontava para uma relação incorreta entre o armazenamento do PhotoPrism e Originals. A correção do mapeamento dos volumes — e não a eliminação repetida do marcador — permitiu iniciar a aplicação.