Communityoplossing

PhotoPrism start niet op ZimaOS: herstel de originelen en de opslagkoppeling

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.

De uiteindelijke oplossing in deze thread was niet “verwijder .ppstorage elke keer”. Het bestand verscheen opnieuw omdat de onderliggende volumelay-out nog steeds niet klopte. De nuttige diagnose kwam uit de logs en de duurzame wijziging bestond uit het corrigeren van de hostmap die aan het Originals-pad van PhotoPrism was gekoppeld.

PhotoPrism-applicatiescherm en logs van een ZimaOS-installatie die niet kon starten
De oorspronkelijke poster deelde de foutieve PhotoPrism-status voordat de opslagkoppelingen werden gecorrigeerd.
PhotoPrism-applicatie-instellingen in ZimaOS met de oorspronkelijke volum configuratie
De app-instellingen werden vergeleken met een werkende communitytemplate om het probleem met het Originals-pad te identificeren.
PhotoPrism-melding waarin staat dat de applicatie niet kon starten met de oorspronkelijke opslagindeling
De melding verscheen samen met logs die wezen op een conflict tussen de opslag en het Originals-pad.
Gecorrigeerde koppeling van PhotoPrism Originals waarmee de applicatie op ZimaOS kon starten
De uiteindelijke screenshot van de community toonde de gewijzigde Originals-koppeling waarmee PhotoPrism kon starten.

De logmelding was een aanwijzing, niet de volledige oplossing

Een reactie wees op een markering .ppstorage in /DATA/Gallery en stelde voor deze te verwijderen. De gebruiker deed dat, maar PhotoPrism maakte de bestanden opnieuw aan en bleef falen. Daaruit bleek dat de padrelatie—en niet alleen het bestand—moest worden gecorrigeerd.

PhotoPrism houdt Originals en Storage gescheiden

De officiële PhotoPrism-opslagmappen vermelden dat de Storage-map configuratie, cache, back-ups, miniaturen en sidecargegevens bevat en normaal gesproken niet binnen Originals moet worden geconfigureerd, tenzij een door PhotoPrism ondersteunde indeling met verborgen namen wordt gebruikt. Deze upstreamregel verklaart waarom het koppelen van applicatieopslag aan de fotomap Originals problemen kan veroorzaken.

De eerste Docker-app legt het model met hostpaden en containerpaden in ZimaOS uit, terwijl de vereisten van de ZimaOS App Store de actuele context op pakketniveau bieden wanneer er meerdere templates of afhankelijkheidsstacks bestaan.

Gebruik logs voordat je databases of machtigingen wijzigt

De officiële probleemoplossing voor PhotoPrism Docker adviseert Docker-logs te controleren en noemt specifiek fouten met schijfruimte, machtigingen, routes en opslag. In dit geval gaf de log voldoende informatie om te voorkomen dat MariaDB willekeurig opnieuw werd opgebouwd, poorten werden gewijzigd of het volledige besturingssysteem opnieuw werd geïnstalleerd.

Wat de werkende wijziging van de community aantoonde

De gebruiker vergeleek de BigBear-template met de koppeling in de ZimaOS App Store, wijzigde de Originals-koppeling en PhotoPrism startte. Dat bevestigt dat de opslagkoppeling doorslaggevend was voor deze installatie; het bewijst niet dat elk huidig PhotoPrism-pakket exact hetzelfde hostpad gebruikt.

Kort samengevat

Als PhotoPrism wordt geïnstalleerd maar onmiddellijk afsluit, lees dan eerst de logs voordat je alles tegelijk wijzigt. In dit geval uit de community wees het herhaaldelijk terugkerende symptoom .ppstorage op een onjuiste relatie tussen PhotoPrism Storage en Originals. Door de volumekoppeling te corrigeren—en niet de markering steeds opnieuw te verwijderen—kon de app starten.