Wenn Immich nach einem ZimaOS-Upgrade stoppt und das Serverprotokoll getaddrinfo EAI_AGAIN immich-postgres meldet, liegt der unmittelbare Fehler in der Namensauflösung zwischen den Containern. Das ist kein Beleg dafür, dass das PostgreSQL-Datenvolume beschädigt ist.
Im ursprünglichen Thread zu Version 1.6.1 führten umbenannte Speicherpfade bei mehreren Anwendungen zu Problemen, aber MariaDB, Plex und Nextcloud funktionierten wieder, nachdem ihre Pfade korrigiert worden waren. Bei Immich war die Situation anders: PostgreSQL war funktionsfähig, während immich-server den Hostnamen immich-postgres nicht auflösen konnte.
Den Immich-Fehler wörtlich lesen
EAI_AGAIN ist ein vorübergehender DNS-Auflösungsfehler. Der Server versuchte, eine Datenbank mit dem Hostnamen immich-postgres zu erreichen, während der Datenbankcontainer selbst meldete, dass er bereit war, Verbindungen anzunehmen.
Damit sind Docker-Netzwerk und Diensterkennung die erste zu prüfende Ebene. Beginnen Sie nicht damit, die Datenbank zu löschen oder die Fotobibliothek neu zu erstellen.
Überprüfen, ob die Immich-Dienste ein Compose-Netzwerk gemeinsam nutzen
Der Netzwerkleitfaden für Docker Compose erklärt, dass Dienste im selben Compose-Netzwerk einander über den Dienstnamen erreichen können. Container-IP-Adressen können sich nach einer Neuerstellung ändern, während der Dienstname stabil bleibt.
Prüfen Sie, ob immich-server, PostgreSQL und Redis mit dem vorgesehenen gemeinsamen Netzwerk verbunden sind und ob der Datenbankhostname in Immich weiterhin mit dem Compose-Dienstnamen übereinstimmt. Ersetzen Sie den Hostnamen nicht dauerhaft durch eine feste Container-IP.
Die Umbenennung des Volumes als separate Migrationsprüfung behandeln
Das Upgrade änderte in dieser Umgebung außerdem einige Speichernamen, indem Leerzeichen durch Unterstriche ersetzt wurden. Die Korrektur dieser Hostpfade war für andere Apps erforderlich. Überprüfen Sie daher auch jeden Immich-Bind-Mount, insbesondere die Pfade für Bibliothek, Uploads und Datenbank.
Der Leitfaden zu Immich-Speicherpfaden und der Leitfaden zur Migration von App-Daten können dabei helfen, Speicherpfadprobleme von Netzwerkproblemen zu unterscheiden.
Den Stack erst nach einer Sicherung der Konfiguration neu erstellen
Nachdem Sie die Compose-Datei und die Pfade bestätigt haben, kann eine Neuerstellung des Immich-Stacks das vorgesehene Docker-Netzwerk und die DNS-Einträge neu aufbauen. Bewahren Sie das Datenbankvolume und die Immich-Bibliothekspfade auf. Verwenden Sie keinen destruktiven Reset als Netzwerktest.
ZimaOS 1.7.1 führte später in seinen Versionshinweisen zu Version 1.7.1 Verbesserungen an der Docker-Netzwerkkonfiguration und der Kompatibilität bei App-Migrationen auf. Das ist ein Grund für ein Update, aber im Changelog wird nicht ausdrücklich behauptet, dass genau dieser Immich-Fall mit EAI_AGAIN behoben wurde.
Fazit
Wenn PostgreSQL funktionsfähig ist, Immich aber EAI_AGAIN immich-postgres meldet, prüfen Sie zuerst die DNS-Auflösung des Dienstnamens und die gemeinsam genutzten Docker-Netzwerke. Überprüfen Sie anschließend separat alle umbenannten Host-Volume-Pfade, die durch das ZimaOS-Upgrade eingeführt wurden.
