Immich kan anslutas till en extern PostgreSQL-tjänst, men då blir uppgraderingar inte automatiskt säkra. Ansvaret för databasversion, tillägg, behörigheter, säkerhetskopiering och återställning flyttas utanför standardlösningen.
Se en extern databas som en avancerad kompatibilitetsgräns, inte som en prestandainställning. Före varje uppgradering av Immich eller PostgreSQL ska du kontrollera kraven för den specifika Immich-versionen du planerar att köra, bekräfta att den externa servern kan tillhandahålla de nödvändiga tilläggen och behörigheterna, skapa en säkerhetskopia som går att återställa och ändra en uppgraderingsnivå i taget så att du vet vilken komponent som orsakat ett fel.
Börja med villkoren för den externa databasen
Dokumentera databasens slutpunkt, databasnamn, tjänstekonto, TLS-läge, PostgreSQL-huvudversion, installerade tillägg och versioner samt vem som kan uppgradera dessa tillägg. Förvara dokumentationen tillsammans med Immichs distributionsdefinition så att återskapandet av en container inte omärkligt ansluter till en annan server eller databas.
Det går att använda en befintlig PostgreSQL-server, men det är inte Immichs rekommenderade standardlösning. I aktuella versioner kräver upplägget med fristående databas pgvector plus VectorChord; Immich fungerar enligt uppgift med PostgreSQL 14 till 19, pgvector >=0.7 och <0.9 samt VectorChord >=0.3 och <2.0. Kontrollera intervallen på nytt före varje uppgradering, eftersom de kan ändras.
Planera behörigheterna före övergången. Immich förutsätter vanligtvis en databasroll med superanvändarbehörighet. Att köra utan den är en avancerad lösning som kan kräva manuella åtgärder vid uppdateringar, och aktuella automatiserade databassäkerhetskopior kräver superanvändarbehörighet. Om din externa leverantör inte kan uppfylla dessa krav ska du avbryta innan du flyttar produktionsdata.
Kontrollera kompatibiliteten mellan PostgreSQL och tillägg innan du ändrar något
Lista de aktuella och målsatta PostgreSQL-versionerna tillsammans med alla tillägg som Immich är beroende av. En större PostgreSQL-uppgradering kan kräva tilläggsbinärer som har byggts för målversionen, medan en Immich-uppgradering kan kräva ett nyare tillägg eller ändrat migreringsbeteende, även om PostgreSQL fortfarande startar.
Tilläggspaketfilerna och SQL-tilläggstillståndet måste hanteras medvetet tillsammans med databasen i stället för att förutsätta att de följer med vid en PostgreSQL-uppgradering. Läs igenom Beroenden för uppgradering av PostgreSQL-tillägg innan du ändrar databasens huvudversion eller de tilläggspaket som Immich kräver.
Om din externa leverantör inte låter dig installera eller uppgradera det nödvändiga tillägget, ändra delade förinläsningsinställningar när det krävs eller bevilja de behörigheter som migreringen behöver, ska du avbryta innan du uppdaterar Immich. En databas som godtar vanliga frågor kan ändå vara olämplig för nästa programvarumigrering.
Håll större databasuppgraderingar åtskilda från Immich-uppgraderingar
Undvik att kombinera en uppgradering till en ny större PostgreSQL-version, en tilläggsuppgradering och en uppgradering av Immich-programmet i samma underhållstillfälle, såvida du inte redan har övat på hela sekvensen. När flera kompatibilitetsgränser ändras samtidigt visar en misslyckad start inte längre vilket lager som orsakade problemet.
Mindre PostgreSQL-uppdateringar och uppgraderingar till en ny större version är olika typer av underhåll, och större uppgraderingar kräver att målmiljön, inklusive tillägg från tredje part, förbereds först. Håll uppgraderingar till en ny större PostgreSQL-version åtskilda från en uppgradering av Immich-programmet när det är möjligt, så att en misslyckad start fortfarande har en tydlig ändring att undersöka.
För en hemmaserver är sekvensen med lägst risk vanligtvis: skapa säkerhetskopior, verifiera en återställning, uppdatera ett lager, köra validering och sedan fortsätta. Om en Immich-version kräver en databasändring följer du den ordning som anges för versionen i stället för att använda en generell uppgraderingsguide för PostgreSQL.
Bevara en återställningsväg som omfattar både databas och media
Med en extern databas är det lättare att glömma att Immich-tillståndet är uppdelat mellan PostgreSQL och mediebiblioteket. Säkerhetskopiera databasen med en databasmedveten metod och bevara relevant media- och konfigurationstillstånd från samma återställningsfönster inför en migrering som kan ändra scheman eller metadata för tillgångar.
Databastillstånd, programfiler, konfiguration och uppladdningar måste stämma överens vid återställning. Använd en konsekvent säkerhetskopia av databaskontainern som acceptanskriterium, inte bara frågan om PostgreSQL startar.
Förklara inte återställningen redo förrän du vet vad som händer med båda delarna om programmigreringen bara lyckas delvis. Behåll den gamla programversionen, driftsättningsdefinitionen, databassäkerhetskopian och medietillståndet tillräckligt länge för att kunna återställa utan att skriva nyare tillstånd över den enda kända fungerande kopian.
Validera uppgraderingen som ett program, inte bara som en databasanslutning
Efter ändringen bekräftar du att PostgreSQL godtar den avsedda Immich-rollen, att de nödvändiga tilläggen finns i förväntade versioner och att Immich-migreringen slutförs utan upprepade databasfel. En lyckad TCP-anslutning eller `SELECT 1` bevisar att anslutningen fungerar, inte att programmet är kompatibelt.
Använd sedan Immich som vanligt: läs in gamla album, öppna representativa foton och videor, sök, granska användare eller delning där det är relevant och ladda upp en tillgång som kan tas bort. Håll koll på programmets och databasens loggar under dessa åtgärder efter saknade tillägg, behörighetsfel, misslyckade migreringar eller upprepade försök.
Först när programmet har klarat dessa kontroller bör du återuppta den normala lagringen av säkerhetskopior och ta bort återställningskopian. Om den externa databasen gång på gång innebär att vanliga uppgraderingar av Immich kräver manuellt arbete med tillägg eller behörigheter som du inte kan öva på ett tillförlitligt sätt, är den dedikerade databasens standardlivscykel det säkrare operativa valet.
Support och tips
Mer att läsa

Så döljer du vuxenvideor på din NAS för familjemedlemmar
Håll vuxenvideor privata på en familje-NAS. Kontrollera mappbehörigheter, åtkomst till bibliotek i Plex och Jellyfin, miniatyrbilder, visningshistorik, delade TV-inloggningar och DLNA.

Vad du bör kontrollera innan du laddar en communitymodell i Transformers
Använd uppdateringen av Transformers Jinja-sandlådan för att granska modellernas ursprung, chattmallar, fjärrkod, serialiserade vikter och isolerade första körningar.

Kör Mirage lokalt: OCR och objektigenkänning från en enda bild
Testa Cactus Computes lilla lokala visionsmodell, validera OCR och objektextrahering med verkliga indata och förstå begränsningarna för minne, språk och integritet.



