Soluzione della community

PhotoPrism non si avvia su ZimaOS: correggi la mappatura degli originali e dello spazio di archiviazione

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.

La soluzione finale in questa discussione non è stata «eliminare .ppstorage ogni volta». Il file ricompariva perché la struttura dei volumi sottostante era ancora errata. La diagnosi utile è emersa dai log, mentre la modifica definitiva consisteva nel correggere la directory host associata al percorso Originals di PhotoPrism.

Schermata dell'applicazione PhotoPrism e log provenienti da un'installazione ZimaOS che non è riuscita ad avviarsi
L'autore del post originale ha condiviso lo stato di PhotoPrism in errore prima di correggere le associazioni dello storage.
Impostazioni dell'applicazione PhotoPrism su ZimaOS che mostrano la configurazione originale del volume
Le impostazioni dell'app sono state confrontate con un modello della community funzionante per individuare il problema del percorso Originals.
Notifica di PhotoPrism che indica l'impossibilità di avviare l'applicazione con la configurazione originale dello storage
La notifica era accompagnata da log che indicavano un conflitto tra lo storage e il percorso Originals.
Associazione corretta del percorso Originals di PhotoPrism che ha permesso all'applicazione di avviarsi su ZimaOS
L'ultima schermata condivisa dalla community mostrava la modifica all'associazione del percorso Originals che ha permesso a PhotoPrism di avviarsi.

Il messaggio del log era un indizio, non la soluzione completa

Una risposta ha individuato un indicatore .ppstorage all'interno di /DATA/Gallery e ha suggerito di eliminarlo. L'utente lo ha fatto, ma PhotoPrism ha ricreato i file e ha continuato a non funzionare. Questo ha dimostrato che era necessario correggere la relazione tra i percorsi, non solo il file.

PhotoPrism separa Originals da Storage

La documentazione ufficiale sulle cartelle di storage di PhotoPrism indica che la cartella Storage contiene configurazione, cache, backup, miniature e dati sidecar e che normalmente non dovrebbe essere configurata all'interno di Originals, a meno che non utilizzi una struttura con nomi nascosti supportata da PhotoPrism. Questa regola a monte spiega perché associare lo storage dell'applicazione all'albero fotografico Originals può creare problemi.

La guida sulla prima app Docker spiega il modello percorso host/percorso container in ZimaOS, mentre i requisiti dell'App Store di ZimaOS forniscono il contesto attuale a livello di pacchetto quando sono presenti più modelli o stack di dipendenze.

Consulta i log prima di modificare database o autorizzazioni

La guida ufficiale alla risoluzione dei problemi di PhotoPrism Docker consiglia di controllare i log Docker e richiama in particolare gli errori relativi a disco, autorizzazioni, percorsi e storage. In questo caso, il log ha fornito informazioni sufficienti per evitare di ricreare MariaDB casualmente, modificare le porte o reinstallare l'intero sistema operativo.

Cosa ha dimostrato la modifica funzionante della community

L'utente ha confrontato il modello BigBear con l'associazione presente nell'App Store di ZimaOS, ha modificato il collegamento Originals e PhotoPrism si è avviato. Questo conferma che l'associazione dello storage era decisiva per questa installazione; non dimostra però che ogni pacchetto PhotoPrism attuale utilizzi esattamente lo stesso percorso host.

In sintesi

Se PhotoPrism viene installato ma si chiude immediatamente, leggi i log prima di modificare tutto contemporaneamente. In questo caso della community, il sintomo ricorrente .ppstorage indicava una relazione errata tra lo storage e Originals di PhotoPrism. La correzione dell'associazione dei volumi, non la ripetuta eliminazione dell'indicatore, ha permesso all'app di avviarsi.