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

Hoe optimaliseer je Immich-databaseverbindingen voor gelijktijdige containers?
Verhoog max_connections niet als eerste. Meet de Immich-sessies, tel de vraag van elke container bij elkaar op, behoud ruimte voor beheerders en stem alleen...

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.

Immich herstellen nadat het databasevolume vol raakt
Verwijder nooit PostgreSQL-WAL om ruimte vrij te maken. Stop schrijfbewerkingen van Immich, behoud de databasestatus, voeg veilig extra opslagcapaciteit toe, herstel PostgreSQL en voorkom...

