Cette source décrit plusieurs pannes d’Immich qui se ressemblent superficiellement, mais qui n’ont pas toutes la même solution. L’application Immich grisée de l’auteur du message d’origine a immédiatement refonctionné après l’exécution de sudo systemctl restart docker. Un autre utilisateur a essayé la même commande sans parvenir à démarrer Immich. Son erreur ultérieure indiquait que le port hôte 2283 était déjà alloué, ce qui constitue un problème différent d’un démon Docker arrêté.
Cette distinction est la principale leçon à retenir : après une mise à jour du système d’exploitation, déterminez d’abord si Docker lui-même fonctionne mal, si un seul projet Compose est défaillant ou si un conteneur obsolète ou en double occupe déjà le port dont Immich a besoin.
Vérifiez d’abord l’état du service Docker
La première recommandation de 777-Spider était de vérifier que Docker fonctionnait correctement. L’auteur du message d’origine a ensuite redémarré Docker et indiqué que tout fonctionnait de nouveau.
Le redémarrage de Docker affecte tous les conteneurs de l’hôte ; utilisez donc cette commande avec discernement et prévoyez le redémarrage des autres applications.
Le redémarrage de Docker n’a pas résolu tous les problèmes d’Immich
Chris a indiqué que le même redémarrage de Docker avait aidé d’autres applications, mais n’avait pas rétabli Immich. Cela montre clairement que systemctl restart docker ne doit pas être considéré comme une solution garantie.
Une erreur indiquait explicitement que le port 2283 était déjà alloué
Pour un cas équivalent actuel, identifiez le conteneur ou le processus qui utilise le port 2283 avant de supprimer ou de recréer quoi que ce soit. D’anciens conteneurs Immich en double ou un projet Compose partiellement recréé peuvent laisser un port occupé.
L’échec du démarrage d’une application Compose concerne la pile applicative
Si Docker exécute normalement Paperless ou d’autres applications, mais qu’Immich échoue avec une erreur Compose, examinez l’état et les journaux des services Immich ainsi que sa définition Compose actuelle, au lieu de réinstaller tout le système d’exploitation.
La réinstallation a aidé un utilisateur, mais lui a coûté du temps et une nouvelle copie des données
Chris a finalement réinstallé Immich et recopié les photos. Il a explicitement insisté sur l’importance des sauvegardes. Il s’agissait d’une décision prise en dernier recours, pas d’une solution confirmée pour tout le monde.
Préservez les données d’application et la base de données d’Immich avant toute réinstallation
L’état d’Immich ne se limite pas au dossier de photos. Préservez la base de données, la configuration de l’application et les chemins des bibliothèques avant de supprimer des conteneurs ou des volumes. Les versions actuelles de ZimaOS conservent les données importantes des applications en dehors des conteneurs temporaires.
Utilisez le modèle actuel de données d’application persistantes de ZimaOS.
Ne considérez pas ce problème comme une régression actuelle d’Immich 1.7.1
La source concerne précisément ZimaOS 1.5.4 et une ancienne génération d’Immich. Les versions actuelles de ZimaOS et Immich v3 sont nettement plus récentes ; reproduisez donc l’erreur actuelle exacte avant d’appliquer une solution de contournement de 2026.
Revenir à une ancienne version d’Immich peut être risqué après des migrations de base de données
Un utilisateur de la source a indiqué être revenu à une version précédente d’Immich. Les mises à niveau actuelles vers une version majeure peuvent migrer l’état de la base de données et de l’application. La prise en charge d’une rétrogradation doit donc être confirmée par la documentation correspondant à la version d’Immich concernée, plutôt que par un simple retour à une ancienne balise d’image.
Un conflit de ports nécessite d’identifier le processus qui utilise déjà le port
L’erreur de la source indique explicitement que Docker n’a pas pu lier le port hôte 2283, car celui-ci était déjà alloué. Cela peut se produire lorsqu’un ancien conteneur Immich fonctionne encore, lorsqu’une deuxième pile utilise le même port ou lorsqu’un autre service y a été mappé.
Avant de supprimer quoi que ce soit, identifiez le conteneur ou le processus qui utilise actuellement le port et déterminez quelle pile doit en être propriétaire.
Une vignette d’application grisée peut indiquer un problème d’état de Docker, et non une perte de données Immich
Pour l’auteur du message d’origine, le redémarrage de Docker a restauré toutes les applications. Cela signifie que l’état grisé d’Immich provenait du moteur de conteneurs, et ne prouvait pas que la base de données de photos ou la bibliothèque avait été supprimée.
Un autre participant n’a pas réussi à rétablir Immich avec le même redémarrage, ce qui montre qu’un simple symptôme dans l’interface ne suffit pas à déterminer la cause profonde.
Lisez l’erreur Compose avant de réinstaller
« Échec du démarrage de l’application Compose » est un message générique. Les informations utiles se trouvent dans le message du service ou du conteneur concerné : conflit de ports, volume manquant, échec de vérification de l’état de la base de données, problème de téléchargement de l’image, fichier YAML invalide ou problème d’autorisations.
Conservez les journaux de l’échec avant de recréer la pile ; une réinstallation peut effacer ces informations.
La version actuelle d’Immich v3 rend les rétrogradations aveugles encore plus risquées
Depuis, Immich a connu plusieurs évolutions majeures de son schéma et de son déploiement. Une base de données Immich v3 moderne peut ne pas fonctionner correctement avec une ancienne image choisie arbitrairement, même si un utilisateur a autrefois rétrogradé une version v1.x en 2026.
Suivez les instructions actuelles d’Immich concernant les migrations et les rétrogradations, et conservez des sauvegardes vérifiées de la base de données et de la bibliothèque avant toute modification majeure de version.
Si une réinstallation est nécessaire, préservez d’abord les chemins persistants
Notez l’emplacement de la bibliothèque de photos, des données PostgreSQL, de la configuration, des données de machine learning et du cache, ainsi que les mappages de volumes actuels. Supprimer des conteneurs temporaires est très différent de supprimer les dossiers persistants de l’hôte.
Une réinstallation propre réussie doit rattacher les données persistantes prévues ou les restaurer depuis une sauvegarde prise en charge, et non vous obliger à recopier depuis zéro l’unique bibliothèque de photos.
FAQ sur l’échec d’Immich 1.5.4
Le redémarrage de Docker a-t-il résolu le problème d’Immich de l’auteur du message d’origine ?
Oui.
A-t-il résolu le problème de tous les utilisateurs du fil ?
Non. Immich d’un autre utilisateur ne fonctionnait toujours pas et a ensuite affiché un conflit concernant le port 2283.
Les utilisateurs actuels doivent-ils immédiatement réinstaller Immich ?
Non. Vérifiez d’abord l’état du service Docker, l’état de Compose, le processus qui utilise le port et la persistance des données.
