Waarom geeft Immich na een herstart geen doorzoekbare privéfoto’s meer terug?

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Immich stopt meestal met het teruggeven van doorzoekbare privéfoto's na een herstart omdat Smart Search het pad naar machine learning is kwijtgeraakt, het model nog niet volledig is geladen of de taken en opslaglezingen die de zoekembeddings opbouwen niet kan voltooien.

Als de tijdlijn de originelen nog steeds toont, ontbreken de foto's waarschijnlijk niet; de zoeklaag is onvolledig. Beschouw een leeg resultaat eerst als een probleem in het servicepad, behoud de database en uploadbibliotheek en maak onderscheid tussen een niet-beschikbare machinelearningcontainer, vertraagde taken, een niet-overeenkomend eindpunt of een probleem met rechten op een persistent pad voordat je iets opnieuw opbouwt.

Maak onderscheid tussen ontbrekende zoekresultaten en ontbrekende foto's

Open eerst rechtstreeks verschillende bekende items vanuit de tijdlijn, albums en een privébibliotheek voordat je de zoekfunctie test. Slagen deze tests, dan kan de database de records vinden en kan Immich de bestanden lezen; mislukken ze, dan is dit een breder bibliotheek- of opslagincident. Stop daarom met zoekgerelateerde wijzigingen en bescherm de betreffende paden.

Voer drie herhaalbare zoekopdrachten uit: een term die eerder werkte, een visueel duidelijke term en een recent geüpload item nadat de achtergrondverwerking voltooid zou moeten zijn. Noteer of de resultaten leeg of verouderd zijn, of beperkt blijven tot oudere foto's. Deze uitkomsten maken onderscheid tussen een volledige storing van het eindpunt en een achterstand bij het indexeren.

Een discussie in de community verzamelt Smart Search-controles voor problemen na een herstart, waaronder bereikbaarheid van het eindpunt en het opnieuw uitvoeren van taken. Gebruik de diagnostische zoekreeks als bewijs voor deze situatie, niet als reden om de database te verwijderen of elk item opnieuw te genereren.

Controleer het machinelearningpad na een herstart

Controleer de gezondheid van de server en de machinelearningcontainer en test vervolgens de geconfigureerde machinelearning-URL vanuit de netwerknamespace die deze aanroept. Een bereikbaar eindpunt met geslaagde modelaanvragen doorstaat deze controle; een geweigerde verbinding, een fout bij naamresolutie of een ongezonde container wijst het servicepad aan dat moet worden hersteld.

Vergelijk de geïmplementeerde servicenaam, poort, omgevingswaarde, imageversie en netwerklidmaatschap met de laatst bekende werkende Compose-definitie. Maak alleen de betreffende container opnieuw aan nadat je een afwijking hebt gecorrigeerd. Een gewone herstart vervangt verouderde containeromgevingswaarden niet, dus controleer de effectieve waarde in de opnieuw aangemaakte workload.

In een gemelde Immich v2.6.1-casus werd een mislukte Smart Search gekoppeld aan een ongezonde machinelearningcontainer. Het versiespecifieke probleemrapport ondersteunt het controleren van de gezondheid en logs; het bewijst niet dat elke storing na een herstart door die regressie wordt veroorzaakt.

Controleer modelgereedheid, taken en persistente paden

Bekijk de machinelearninglogs terwijl je één bekende zoekopdracht verstuurt. Een eerste aanvraag kan een model laden of downloaden en tijdelijk meer geheugen gebruiken; voortgang gevolgd door een geslaagde respons is een goed teken. Herhaaldelijk verwijderen uit het geheugen, beëindiging door geheugengebrek of een mislukte download wijst op herstel van geheugen, cachepersistentie of netwerkverbinding.

Controleer de aantallen Smart Search-taken en recente fouten zonder ze te wissen. Als het eindpunt gezond is maar taken mislukt of in de wachtrij blijven staan, probeer dan een kleine, gecontroleerde batch opnieuw en kijk of de aantallen dalen. Als één item slaagt, herstel dan de worker-concurrentie of de mislukte afhankelijkheid voordat je een volledige herindexering plant.

Bevestig dat de database, uploadbibliotheek en modelcache op de bedoelde persistente paden zijn gekoppeld en de verwachte identiteit gebruiken. De gerelateerde ZimaSpace-handleiding over herkenningsgedrag van Immich helpt om toegangs- en indexeringsbereik te onderscheiden van een ontbrekend origineel.

Pas de passende oplossing toe en test twee herstarts opnieuw

Corrigeer alleen de bevestigde oorzaak: herstel de eindpuntnaam, maak de container opnieuw aan met de juiste omgeving, bewaar de modelcache persistent, verlaag de gemeten gelijktijdigheid, herstel de eigenaarschap of probeer mislukte Smart Search-taken opnieuw. Houd het vorige Compose-bestand en een databaseback-up bij de hand; verwijder embeddings niet als eerste maatregel.

Test dezelfde drie zoekopdrachten opnieuw, samen met één oud item en één nieuwe upload. Slagen vereist bruikbare resultaten, wachtrijen met afnemende taken, leesbare originelen en een stabiele machinelearningstatus. Herstart de stack in de normale volgorde van afhankelijkheden en herhaal dit, en herstart daarna eenmaal de host om te bewijzen dat koppelingen en naamresolutie de opstart overleven.

Rol terug als de resultaten afnemen, originelen onleesbaar worden of de database consistentiefouten meldt. Escaleer met de Immich-versie, het effectieve eindpunt, de containerstatus, relevante logs, taakaantallen, modelnaam en koppelingsconfiguraties als dezelfde storing na twee herstarts terugkeert; houd de oude doorzoekbare instantie geïsoleerd maar herstelbaar.

Ondersteuning & Tips

Meer om te lezen

Dubbele taken of imports in Immich voorkomen
Sep 08, 2026

Dubbele taken of imports in Immich voorkomen

Scheid herhaalde taken van dubbele assets. Gebruik één canoniek ingestiepad, beheer retries en padwijzigingen en test vervolgens opnieuw invoeren op een kleine groep.

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.