Förhindra att Immich-konfiguration går förlorad vid uppgraderingar genom att behandla Compose-filen, miljövärdena, databasen, uppladdningsbiblioteket och monteringsdefinitionerna för externa bibliotek som separata beständiga tillgångar som måste säkerhetskopieras och återställas tillsammans.
En container kan ersättas; konfigurationen runt den kan inte det. En uppgradering kan verka radera Immich om en relativ bindningsmontering löses utifrån en annan projektkatalog, en miljöändring aldrig når den återskapade containern eller den nya stacken startar mot en tom databas. Inventera först den aktiva driftsättningen, spara versionshanterade kopior utanför värden och verifiera en kontrollerad återskapning före produktionsövergången.
Dokumentera den aktiva driftsättningen före varje uppgradering
Exportera den effektiva Compose-konfigurationen med hemligheter maskerade, notera bildversioner eller digest-värden och kopiera Compose- och miljöfilerna till versionshanrad lagring. Kontrollera de monterade sökvägarna i den körande miljön i stället för att anta att filen i redigeraren startade de aktuella containrarna. Godkänt innebär att varje sökväg i körmiljön motsvarar en känd värdsökväg.
Notera sökvägar för externa bibliotek, inställningar för omvänd proxy, URL för maskininlärning, databasanslutningsvärden, användar- och gruppidentitet, nätverksnamn och eventuella enheter för hårdvaruacceleration. Om något saknas här blir det en oförklarlig skillnad efter uppgraderingen.
Frågor från communityn om uppgraderingar visar gång på gång att operatörer tappar reda på vilken Compose-generation eller miljölayout som gäller. Den användbara lärdomen från en diskussion om konfiguration vid uppgradering är att spara den fungerande konfigurationen innan den översätts.
Säkerhetskopiera databasen, medierna och distributionsfilerna separat
Gör en databasinbyggd säkerhetskopiering samt en säkerhetskopiering eller ögonblicksbild av filsystemet för uppladdningsbiblioteket och distributionskatalogen. Notera start- och sluttider, arkivstorlekar och kontrollsummor. En säkerhetskopia som bara innehåller Compose-YAML kan återskapa containrar, men inte konton, metadata, album eller resursposter.
Använd en avstängd säkerhetskopiering för den enklaste konsekvensgränsen, eller samordna en aktiv databassdumpning och en lagringsögonblicksbild så att sambandet dokumenteras. Ta med externa bibliotek i inventeringen även om Immich inte äger originalfilerna, eftersom sökvägar och åtkomstregler fortfarande påverkar den återställda tjänsten.
En procedur för uppgradering till en ny huvudversion som underhålls av communityn betonar vikten av att bevara databasen, mediefilerna, Compose-konfigurationen och miljövariablerna. Se sekvensen som operatörserfarenhet och kontrollera varje steg mot den version du faktiskt distribuerar.
Testa uppgraderingen med låsta versioner
Läs versionsinformationen för varje version du hoppar över och uppdatera den sparade distributionsdefinitionen med avsikt. Lås målversionen, hämta den utan att ta bort gamla avbildningar och validera den renderade Compose-konfigurationen. Okända variabler, tomma monteringar eller blandade tjänsteversioner innebär att stagingkontrollen inte godkänns.
Om kapaciteten tillåter återställer du säkerhetskopian till en isolerad teststack med andra portar och utan skrivbehörighet till produktionen. Starta den med målversionen och granska migreringar, användare, lagringssökvägar och bakgrundsjobb. Att en container startar utan problem bevisar inte att det ursprungliga biblioteket är anslutet.
Den relaterade ZimaSpace-guiden till en säker, egenhostad NAS hjälper dig att placera distributionsfiler och säkerhetskopior utanför den enda värdens och autentiseringsuppgifternas gräns, som en uppgradering kan påverka.
Verifiera att konfigurationen finns kvar efter återskapande
Innan produktionsväxlingen återskapar du testcontainrarna från de sparade filerna i stället för att starta om dem på plats. Verifiera användare, serverinställningar, lagringsmallar, bibliotek, jobb, proxytillgång och effektiva miljövärden. Godkänt innebär att konfigurationen finns kvar efter ersättningen eftersom den lagras i dokumenterade beständiga komponenter.
Efter produktionsväxlingen laddar du upp en testtillgång, gör en sökning, öppnar en originalfil och skapar en ny säkerhetskopia av databasen. Starta om stacken och värden och upprepa sedan. Behåll den gamla versionen, säkerhetskopian och distributionsdefinitionen tills den normala arbetsbelastningen har varit stabil under hela observationsperioden.
Om uppgraderingen redan har startat utan innehåll ska du avbryta den innan introduktionsflödet eller nya uppladdningar skapar motstridiga tillstånd. Anslut bara en verifierad beständig sökväg eller återställ till ett rent mål. Återställ den tidigare versionen om förväntade användare eller tillgångar saknas. Eskalera med sanerad effektiv Compose-konfiguration, monteringar, versioner och tidsstämplar för säkerhetskopior om identiteten fortfarande är oklar.
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.



