En säker checklista för att migrera Immich till en ny hemmaserver

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

En säker Immich-migrering börjar med att du tar reda på vad som måste bevaras innan du kopierar något: fotofilerna, databasen och driftsättningsinställningarna som kopplar ihop dem på den nya värden.

På en hemmaserver uppstår migreringsrisker oftast när de här delarna flyttas vid olika tidpunkter eller när målsystemet startas med fel sökvägar. Behandla den gamla servern som återställningskopia, förhindra onödiga skrivningar, dokumentera aktuell version och lagringskopplingar och flytta sedan en verifierad datauppsättning till den nya maskinen. Checklista nedan hjälper dig att hålla arbetet reversibelt tills den nya instansen kan logga in, hitta originalbiblioteket, bearbeta jobb och klara en omstart utan att återgå till ett tomt läge.

Frys källan och dokumentera det fungerande läget

Börja på den fungerande servern, inte den nya. Anteckna Immich-versionen, Compose- eller appbutiksdefinitionen, miljövärdena som styr databas- och lagringssökvägar, fotobibliotekets plats, databasens plats och eventuella monteringar av externa bibliotek. Anteckna även serverns aktuella URL och användarkontot som du tänker använda för verifieringen.

Syftet med den här inventeringen är att förhindra att en migrering i det tysta blir en uppgradering, en omstrukturering av sökvägar och en nätverksändring på samma gång. Håll applikationsversionen och den logiska lagringsstrukturen så stabila som möjligt tills återställningen har godkänts. Versionsändringar kan hanteras när du har verifierat målsystemet.

Innan du kopierar, stoppa eller pausa nya uppladdningar om det fungerar för hushållet. Om det inte är praktiskt möjligt, bestäm ett tidsfönster för övergången och planera en sista kort synkronisering. När det här steget är klart ska du ha en skriftlig källöversikt som visar var originalfilerna finns, var databastillståndet finns och vilken konfiguration som återskapar samma kopplingar.

Samla databas, filer och konfiguration i en enda migreringsuppsättning

Behandla databasen och mediefilerna som en enda återställningsuppsättning, inte som två oberoende säkerhetskopior. Aktuella säkerhetskopior av Immich-databasen innehåller metadata och filreferenser, inte själva fotona eller videorna. Databassäkerhetskopian måste därför flyttas tillsammans med motsvarande innehåll i UPLOAD_LOCATION och eventuella data i externa bibliotek som du hanterar separat.

Ett användbart migreringsunderlag behöver tillgångarna, PostgreSQL-tillståndet och konfigurationen som kopplar ihop dem igen. En komplett Immich-säkerhetskopia innehåller uppladdade tillgångar, en säkerhetskopia av databasen som stöds och driftsättningskonfiguration, och återställningstest används för att bevisa att underlaget fungerar. Förvara delarna tillsammans så att målet kan matchas mot en och samma återställningspunkt.

Verifiera migreringsunderlaget innan du gör något på målet. Bekräfta att databasuttaget inte är tomt, kontrollera flera originalfiler från det kopierade biblioteket och spara Compose- och miljöfilerna i samma migreringsmapp eller dokumentationsuppsättning. Om någon del inte kan verifieras ska du avbryta här och göra en ny kopia i stället för att försöka kompensera på den nya servern.

Förbered den nya värden utan att skapa konkurrerande tillstånd

Skapa målkatalogerna och monteringspunkterna först, och bekräfta sedan att den nya värden ser de avsedda diskarna eller nätverksresurserna på exakt de sökvägar du tänker använda. Om en NAS-montering saknas kan en vanlig tom katalog bli kvar, och en container kan utan problem initieras mot den reservsökvägen.

Installera körmiljön och återskapa driftsättningsdefinitionen, men låt inte en tom Immich-instans samla på sig uppladdningar eller konfiguration innan det gamla tillståndet har återställts. Se till att autentiseringsuppgifter, databasnamn, lagringsvariabler och monteringsmål för externa bibliotek stämmer överens med källan, såvida inte migreringsplanen uttryckligen omfattar en kontrollerad ändring av sökvägar.

Om den nya servern kräver andra sökvägar på värdsidan ska du mappa dem medvetet och samtidigt se till att sökvägarna som är synliga i containern och databasens förväntningar stämmer överens. Målet är klart först när de faktiska monteringspunkterna pekar på de kopierade dataplatsen och du kan förklara varje sökvägsöversättning innan hela programmet startas.

Återställ tillståndet och återanslut alla lagringssökvägar

Återställ databasen med den återställningsmetod som passar den Immich-version som skapade säkerhetskopian, och starta de återstående tjänsterna först när databasen är klar. Improvisera inte med destruktiva databaskommandon från en äldre guide om en nyare installation använder ett annat återställningsflöde.

Under övergången ska du bevara kopplingen mellan databasen och lagringen innan normal användning återupptas. En testad Immich-migreringssekvens följer samma princip: programmet ska öppnas med det återställda databastillståndet och de avsedda mediesökvägarna, inte initiera ett nytt bibliotek och tvinga fram en ombyggnad från grunden.

Kontrollera åtkomsten till lagringen efter start, innan du kör tunga bakgrundsjobb. Öppna flera gamla objekt från olika datum, kontrollera att miniatyrbilder läses in, bekräfta ett album och en person eller ett sökresultat som fanns före migreringen och se till att externa bibliotek går att läsa om du använder sådana. En ny introduktionsskärm eller tom tidslinje är en stoppsignal: kontrollera databas- och monteringsmappningarna igen innan du skriver något nytt tillstånd.

Validera den ursprungliga arbetsbelastningen innan du avvecklar den gamla servern

En lyckad första inloggning innebär inte att migreringen är klar. Ladda upp ett testfoto som kan tas bort från den vanliga klienten, kontrollera att det visas på förväntad lagringsplats på värden och radera det sedan via Immich. Kontrollera därefter att biblioteket fortfarande fungerar som det ska. Det här testar hela skrivvägen i stället för att bara bevisa att gamla data går att läsa.

Starta om den nya hemservern och upprepa de kontroller som är viktiga för hushållet: inloggning i webbläsaren, anslutning för mobil säkerhetskopiering, flera gamla foton, sökning, en representativ video, jobbköer och fjärråtkomst om det ingår i den vanliga konfigurationen. Migreringen är klar först när samma tillstånd består efter en omstart av värden och lagringsmonteringarna är klara innan Immich startar.

Låt den gamla servern vara avstängd men oförändrad under en återställningsperiod i stället för att radera den direkt. Om den nya instansen börjar skriva till en oväntat tom mapp, inte kan återskapa det gamla biblioteket efter omstart eller visar databasfel som du inte kan förklara, stoppar du nya uppladdningar och återgår till den beprövade källan medan du jämför migreringsuppsättningen. Avveckla den gamla värden först när destinationen har klarat normal användning och ett nytt säkerhetskopieringstest.

Support och tips

Mer att läsa

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.