Deze bron bevat verschillende, oppervlakkig vergelijkbare Immich-storingen, maar niet één universele oplossing. De grijs weergegeven Immich-app van de oorspronkelijke poster werkte onmiddellijk weer na sudo systemctl restart docker. Een andere gebruiker probeerde hetzelfde commando, maar kon Immich nog steeds niet starten. Uit de latere foutmelding bleek dat hostpoort 2283 al in gebruik was. Dat is een ander probleem dan een niet-werkende Docker-daemon.
Dat onderscheid is de belangrijkste les: bepaal na een besturingssysteemupdate eerst of Docker zelf defect is, slechts één Compose-project problemen heeft, of dat een verouderde of dubbele container al de poort gebruikt die Immich nodig heeft.
Controleer eerst de status van de Docker-service
De eerste aanbeveling van 777-Spider was om te controleren of Docker correct werkte. De oorspronkelijke poster startte Docker vervolgens opnieuw en meldde dat alles weer werkte.
Docker opnieuw starten heeft gevolgen voor elke container op de host. Doe dit daarom bewust en houd er rekening mee dat andere applicaties opnieuw worden gestart.
Docker opnieuw starten was geen universele oplossing voor Immich
Chris meldde dat dezelfde Docker-herstart andere apps hielp, maar Immich niet herstelde. Dit is direct bewijs dat systemctl restart docker niet als gegarandeerde oplossing moet worden beschouwd.
Een bronfout liet expliciet zien dat poort 2283 al in gebruik was
Identificeer bij een vergelijkbare huidige situatie eerst welke container of welk proces poort 2283 gebruikt voordat je iets verwijdert of opnieuw aanmaakt. Dubbele oude Immich-containers of een gedeeltelijk opnieuw aangemaakt Compose-project kunnen een poort bezet houden.
Een Compose-app die niet start, is een fout in de applicatiestack
Als Docker Paperless of andere apps normaal uitvoert, maar Immich faalt met een Compose-fout, controleer dan de statussen en logs van de Immich-services en de huidige Compose-definitie in plaats van het hele besturingssysteem opnieuw te installeren.
Opnieuw installeren hielp één gebruiker, maar kostte tijd en het opnieuw kopiëren van gegevens
Chris installeerde Immich uiteindelijk opnieuw en kopieerde de foto's terug. Daarbij werd expliciet gewaarschuwd om back-ups te maken. Dat was een beslissing als laatste redmiddel van één gebruiker, niet de bevestigde oplossing voor iedereen.
Bewaar de Immich-appgegevens en database voordat je opnieuw installeert
De Immich-status bestaat niet alleen uit de fotomap. Bewaar de database, applicatieconfiguratie en bibliotheekpaden voordat je containers of volumes verwijdert. Het huidige ZimaOS bewaart belangrijke appgegevens buiten wegwerpcontainers.
Gebruik het huidige model voor persistente appgegevens van ZimaOS.
Beschouw dit niet als een huidige Immich-regressie in versie 1.7.1
De bron gaat specifiek over ZimaOS 1.5.4 en een oudere generatie van Immich. Het huidige ZimaOS en Immich v3 zijn aanzienlijk nieuwer. Reproduceer daarom eerst de exacte huidige fout voordat je een workaround uit 2026 toepast.
Immich terugzetten kan onveilig zijn na databasemigraties
Een gebruiker uit de bron zei dat die naar een vorige Immich-versie was teruggekeerd. Upgrades naar huidige hoofdversies kunnen de database- en applicatiestatus migreren. Ondersteuning voor downgraden moet daarom afkomstig zijn uit de instructies voor de bijbehorende Immich-release, in plaats van simpelweg een image-tag terug te zetten.
Bij een poortconflict moet je de bestaande listener identificeren
De bronfout vermeldt expliciet dat Docker hostpoort 2283 niet kon koppelen omdat deze al in gebruik was. Dit kan gebeuren wanneer een oude Immich-container nog actief is, een tweede stack dezelfde poort gebruikt of een andere service daarheen is doorgestuurd.
Identificeer voordat je iets verwijdert de huidige container of listener die de poort gebruikt en bepaal welke stack deze moet beheren.
Een grijze apptegel kan een symptoom zijn van de Docker-status, niet van gegevensverlies in Immich
Bij de oorspronkelijke poster herstelde het opnieuw starten van Docker alle apps. Dat betekent dat de grijze status van Immich het gevolg was van de containeromgeving en niet aantoonde dat de fotodatabase of bibliotheek was verwijderd.
Een andere deelnemer kreeg Immich niet hersteld met dezelfde herstart. Dit laat zien waarom alleen het UI-symptoom onvoldoende is om de oorzaak vast te stellen.
Lees de Compose-fout voordat je opnieuw installeert
‘Compose-app starten mislukt’ is een algemene foutmelding. Het bruikbare bewijs staat in de onderliggende melding van de service of container: een poortconflict, ontbrekend volume, database die niet gezond is, probleem met het ophalen van een image, ongeldige YAML of een rechtenprobleem.
Bewaar de logs van de fout voordat je de stack opnieuw aanmaakt; een herinstallatie kan het bewijsmateriaal wissen.
Het huidige Immich v3 maakt blind terugzetten riskanter
Immich heeft sindsdien belangrijke wijzigingen in schema en implementatie ondergaan. Een moderne v3-database is mogelijk niet veilig te gebruiken met een willekeurige oudere image, alleen omdat een gebruiker in 2026 ooit een v1.x-release heeft teruggezet.
Volg de actuele migratie- en rollback-instructies van Immich en zorg vóór wijzigingen naar een hoofdversie voor geverifieerde back-ups van zowel de database als de bibliotheek.
Als opnieuw installeren nodig is, bewaar dan eerst de persistente paden
Noteer de fotobibliotheek, PostgreSQL-gegevens, configuratie, paden voor machine learning en cache, en de huidige volumekoppelingen. Wegwerpcontainers verwijderen is iets heel anders dan die persistente hostmappen verwijderen.
Bij een succesvolle schone herinstallatie moeten de bedoelde persistente gegevens opnieuw worden gekoppeld of via een ondersteund back-uppad worden teruggezet. Het mag niet nodig zijn om de enige fotobibliotheek volledig opnieuw te kopiëren.
Veelgestelde vragen over de Immich-storing in versie 1.5.4
Heeft het opnieuw starten van Docker Immich bij de oorspronkelijke poster hersteld?
Ja.
Heeft het elke gebruiker in de thread geholpen?
Nee. Bij een andere gebruiker bleef Immich falen en werd later een conflict met poort 2283 weergegeven.
Moeten huidige gebruikers Immich onmiddellijk opnieuw installeren?
Nee. Controleer eerst de status van de Docker-service, de Compose-status, wie de poort gebruikt en de persistente gegevens.
