Kann Immich eine externe Datenbank verwenden, ohne Upgrades zu beeinträchtigen?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Immich kann auf einen externen PostgreSQL-Dienst verweisen, doch dadurch werden Upgrades nicht automatisch sicher. Stattdessen liegen die Verantwortung für Datenbankversion, Erweiterungen, Berechtigungen, Sicherungen und Rollback außerhalb des standardmäßigen Stacks.

Betrachten Sie eine externe Datenbank als anspruchsvolle Kompatibilitätsgrenze, nicht als bloßen Leistungsschalter. Prüfen Sie vor jedem Upgrade von Immich oder PostgreSQL die Anforderungen der konkreten Immich-Version, die Sie ausführen möchten. Stellen Sie sicher, dass der externe Server die erforderlichen Erweiterungen und Berechtigungen bereitstellen kann, erstellen Sie eine wiederherstellbare Sicherung und ändern Sie jeweils nur eine Upgrade-Ebene, damit Sie erkennen, welche Komponente einen Fehler verursacht hat.

Beginnen Sie mit den Rahmenbedingungen der externen Datenbank

Dokumentieren Sie den Datenbankendpunkt, den Datenbanknamen, das Dienstkonto, den TLS-Modus, die PostgreSQL-Hauptversion, die installierten Erweiterungen samt Versionen und die Personen, die diese Erweiterungen aktualisieren dürfen. Bewahren Sie diese Angaben zusammen mit der Immich-Bereitstellungskonfiguration auf, damit beim Neuerstellen eines Containers nicht unbemerkt eine Verbindung zu einem anderen Server oder einer anderen Datenbank hergestellt wird.

Ein bereits vorhandener PostgreSQL-Server ist möglich, wird von Immich jedoch nicht standardmäßig empfohlen. Bei aktuellen Versionen erfordert der Betrieb mit einer eigenständigen Datenbank pgvector und VectorChord. Immich funktioniert bekanntermaßen mit PostgreSQL 14 bis 19, pgvector >=0.7 und <0.9 sowie VectorChord >=0.3 und <2.0. Prüfen Sie diese Versionsbereiche vor jedem Upgrade erneut, da sie sich ändern können.

Planen Sie die Berechtigungen vor der Umstellung. Immich setzt in der Regel eine Datenbankrolle mit Superuser-Rechten voraus. Der Betrieb ohne diese Rechte ist ein fortgeschrittener Ansatz, der bei Updates manuelle Eingriffe erfordern kann. Für aktuelle automatisierte Datenbanksicherungen sind Superuser-Rechte erforderlich. Wenn Ihr externer Anbieter diese Anforderungen nicht erfüllen kann, halten Sie an, bevor Sie den Produktivbetrieb umstellen.

Prüfen Sie die Kompatibilität von PostgreSQL und Erweiterungen, bevor Sie Änderungen vornehmen

Führen Sie die aktuellen und die Zielversionen von PostgreSQL sowie alle Erweiterungen auf, von denen Immich abhängt. Bei einem größeren PostgreSQL-Upgrade sind möglicherweise Erweiterungs-Binärdateien erforderlich, die für die Zielversion erstellt wurden. Ein Immich-Upgrade kann außerdem eine neuere Erweiterung oder ein anderes Migrationsverhalten erfordern, selbst wenn PostgreSQL selbst weiterhin startet.

Erweiterungspaketdateien und der SQL-Status der Erweiterung müssen gezielt zusammen mit der Datenbank migriert werden. Gehen Sie nicht davon aus, dass sie bei einem PostgreSQL-Upgrade automatisch mitübernommen werden. Lesen Sie Abhängigkeiten beim Upgrade von PostgreSQL-Erweiterungen, bevor Sie die Hauptversion der Datenbank oder die von Immich benötigten Erweiterungspakete ändern.

Wenn Ihr externer Anbieter es Ihnen nicht ermöglicht, die erforderliche Erweiterung zu installieren oder zu aktualisieren, bei Bedarf gemeinsam genutzte Preload-Einstellungen zu ändern oder die für die Migration erforderlichen Berechtigungen zu erteilen, halten Sie vor dem Aktualisieren von Immich an. Eine Datenbank, die gewöhnliche Abfragen akzeptiert, kann für die nächste Anwendungsmigration trotzdem ungeeignet sein.

Halten Sie größere Datenbank-Upgrades von Immich-Upgrades getrennt

Vermeide es, ein PostgreSQL-Hauptversionsupgrade, ein Erweiterungsupgrade und ein Immich-Anwendungsupgrade in einem Wartungsvorgang zu kombinieren, es sei denn, du hast die gesamte Abfolge bereits geprobt. Wenn sich mehrere Kompatibilitätsgrenzen gleichzeitig verschieben, lässt sich bei einem fehlgeschlagenen Start nicht mehr erkennen, welche Ebene die Ursache war.

PostgreSQL-Minor-Updates und Upgrades auf eine neue Hauptversion sind unterschiedliche Wartungsarbeiten. Bei Hauptversions-Upgrades muss zunächst die Zielumgebung einschließlich Erweiterungen von Drittanbietern vorbereitet werden. Halte PostgreSQL-Upgrades auf eine neue Hauptversion nach Möglichkeit von einem Immich-Anwendungsupgrade getrennt, damit bei einem fehlgeschlagenen Start eine klar abgrenzbare Änderung zu untersuchen ist.

Für einen Heimserver ist die risikoärmste Reihenfolge in der Regel: Backups erstellen, eine Wiederherstellung überprüfen, eine Ebene aktualisieren, validieren und erst dann fortfahren. Erfordert eine Immich-Version eine Datenbankänderung, befolge die dafür vorgesehene Reihenfolge, statt ein allgemeines PostgreSQL-Upgrade-Rezept anzuwenden.

Bewahre einen Rollback-Pfad, der sowohl Datenbank als auch Medien abdeckt

Bei einer externen Datenbank kann man leicht vergessen, dass der Immich-Status auf PostgreSQL und die Medienbibliothek verteilt ist. Sichere die Datenbank mit einer datenbankkonsistenten Methode und bewahre den relevanten Medien- und Konfigurationsstatus aus demselben Wiederherstellungszeitraum auf, bevor du eine Migration durchführst, die Schemas oder Asset-Metadaten ändern kann.

Datenbankstatus, Anwendungsdateien, Konfiguration und Uploads müssen zum Zeitpunkt der Wiederherstellung zusammenpassen. Verwende ein konsistentes Backup des Datenbank-Containers als Abnahmekriterium und nicht einfach nur die Frage, ob PostgreSQL startet.

Erkläre den Rollback nicht für einsatzbereit, bevor du weißt, was auf beiden Seiten geschieht, wenn die Anwendungsmigration nur teilweise erfolgreich ist. Halte die alte Anwendungsversion, die Deployment-Definition, die Datenbanksicherung und den Medienstatus lange genug verfügbar, um die Wiederherstellung durchzuführen, ohne neuere Daten über die einzige bekannte funktionierende Kopie zu schreiben.

Das Upgrade als Anwendung validieren, nicht nur die Datenbankverbindung

Bestätige nach der Änderung, dass PostgreSQL die vorgesehene Immich-Rolle akzeptiert, die erforderlichen Erweiterungen in den erwarteten Versionen vorhanden sind und die Immich-Migration ohne wiederholte Datenbankfehler abgeschlossen wird. Eine erfolgreiche TCP-Verbindung oder `SELECT 1` bestätigt die Verbindung, nicht die Kompatibilität mit der Anwendung.

Nutze Immich anschließend wie gewohnt: Lade alte Alben, öffne repräsentative Fotos und Videos, suche, überprüfe gegebenenfalls Benutzer oder Freigaben und lade ein entbehrliches Asset hoch. Beobachte währenddessen die Anwendungs- und Datenbankprotokolle auf fehlende Erweiterungen, Berechtigungsfehler, fehlgeschlagene Migrationen oder wiederholte Versuche.

Erst wenn die Anwendung diese Prüfungen bestanden hat, solltest du die normale Backup-Aufbewahrung wieder aufnehmen und die Rollback-Kopie entfernen. Wenn die externe Datenbank routinemäßige Immich-Upgrades wiederholt von manuellen Erweiterungs- oder Berechtigungsarbeiten abhängig macht, die du nicht zuverlässig testen kannst, ist der standardmäßige Lebenszyklus einer dedizierten Datenbank die sicherere Betriebsoption.

Support und Tipps

Mehr zum Lesen

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.