Gemenskapslösning

PhotoPrism startar inte på ZimaOS: åtgärda mappningen av original och lagring

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.

Den slutliga lösningen i den här tråden var inte att ”radera .ppstorage varje gång”. Filen kom tillbaka eftersom den underliggande volymlayouten fortfarande var felaktig. Den användbara diagnosen kom från loggarna, och den varaktiga förändringen var att korrigera vilken värddator-katalog som mappades till PhotoPrisms Originals-sökväg.

PhotoPrisms applikationsskärm och loggar från en ZimaOS-installation som inte kunde starta
Det ursprungliga inlägget visade PhotoPrisms felande tillstånd innan lagringsmappningarna korrigerades.
PhotoPrisms applikationsinställningar i ZimaOS som visar den ursprungliga volymkonfigurationen
Appinställningarna jämfördes med en fungerande community-mall för att identifiera problemet med Originals-sökvägen.
PhotoPrism-notis som visar att applikationen inte kunde starta med den ursprungliga lagringslayouten
Notisen kom tillsammans med loggar som pekade på konflikten mellan lagringen och Originals-sökvägen.
Korrigerad mappning av PhotoPrisms Originals som gjorde att applikationen kunde starta i ZimaOS
Den slutliga skärmbilden från communityn visade den ändrade Originals-mappningen som gjorde att PhotoPrism kunde starta.

Loggmeddelandet var en ledtråd, inte hela lösningen

Ett svar uppmärksammade en .ppstorage-markör i /DATA/Gallery och föreslog att den skulle raderas. Användaren gjorde det, men PhotoPrism återskapade filerna och fortsatte att misslyckas. Det visade att sökvägsrelationen – inte bara filen – behövde korrigeras.

PhotoPrism skiljer på Originals och Storage

De officiella lagringsmapparna i PhotoPrism anger att Storage-mappen innehåller konfiguration, cache, säkerhetskopior, miniatyrbilder och sidodata. Den bör normalt inte konfigureras inuti Originals, såvida den inte använder en dold namnstruktur som stöds av PhotoPrism. Den regeln uppströms förklarar varför en mappning av applikationslagring till fotomappen Originals kan skapa problem.

Den första Docker-appen förklarar modellen med värdsökväg och containersökväg i ZimaOS, medan kraven för ZimaOS App Store ger aktuell kontext på paketnivå när det finns fler än en mall eller beroendestack.

Använd loggar innan du ändrar databaser eller behörigheter

Den officiella felsökningen för PhotoPrism Docker rekommenderar att man kontrollerar Docker-loggarna och nämner särskilt disk-, behörighets-, routing- och lagringsfel. I det här fallet gav loggen tillräckligt med information för att undvika att slumpmässigt bygga om MariaDB, ändra portar eller installera om hela operativsystemet.

Vad den fungerande ändringen i communityn bevisade

Användaren jämförde BigBear-mallen med mappningen i ZimaOS App Store, ändrade Originals-länken och PhotoPrism startade. Det bekräftar att lagringsmappningen var avgörande för den här installationen, men bevisar inte att alla aktuella PhotoPrism-paket använder exakt samma värdsökväg.

Sammanfattning

Om PhotoPrism installeras men avslutas direkt bör du läsa loggarna innan du ändrar allt på en gång. I det här fallet i communityn pekade det återkommande .ppstorage-symtomet på en felaktig relation mellan PhotoPrisms Storage och Originals. Genom att korrigera volymmappningen – i stället för att upprepade gånger radera markören – kunde appen starta.