Så migrerade jag 14000 foton till ZimaCube 2 utan någon dataförlust — en migrationsguide för Immich

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.

💡 I rampljuset: u/Ambitious_Shallot_79, r/minilab

Du har ett fotobibliotek. Åratal av minnen. Album som du har organiserat omsorgsfullt. Ansikten som du har taggat. Delade länkar som du har skickat till familjen.

Sedan uppgraderar du din NAS – och inser att det inte räcker att flytta filerna. Utan databasen förlorar du alla album, alla ansiktstaggar och alla minnen du har samlat på dig. Foton finns kvar, men organiseringen är borta.

Jag har just flyttat 14 505 foton och 925 videor – totalt 134 GiB – från en egenbyggd ZimaOS-server till ZimaCube 2. Alla album följde med. Alla ansiktstaggar fanns kvar. Alla delade länkar fungerar fortfarande.

Här är exakt hur jag gjorde, vad som nästan gick fel och vad ZimaCube 2 tillförde som min gamla konfiguration inte kunde erbjuda.

Varför Immich, varför nu

Immich har blivit det självklara valet för en självhostad fotolösning av en anledning. Det ger dig funktioner i Google Foto-klass – ansiktsigenkänning, semantisk sökning, automatiska säkerhetskopior från din telefon och delade album – utan att skicka dina foton till någon annans server.

Men Immich har sin själ i PostgreSQL. Databasen innehåller album, ansiktsvektorer, persongrupper, CLIP-inbäddningar för smart sökning och all metadata som gör att biblioteket känns som ditt eget. Flytta filerna utan databasen, så får du en mapp full av foton och en tom Immich-instans.

Den här migreringen hade en regel: ingen dataförlust. Den gamla servern skulle inte raderas förrän den nya hade verifierats.

Vad Immich faktiskt lagrar (och varför det spelar roll)

Innan jag rörde några filer kartlade jag exakt vad som behövde flyttas:

Komponent Plats Innehåll Måste migreras?
pgdata /DATA/AppData/immich/pgdata Hela PostgreSQL-databasen – album, ansikten, personer, metadata ✅ Kritiskt
model-cache /DATA/AppData/immich/model-cache Nedladdade modeller för CLIP/ansiktsigenkänning ✅ Slipper ladda ned igen
Fotobibliotek /DATA/Gallery/immich 14 505 foton + 925 videor + miniatyrbilder (134 GiB) ✅ Faktiska medier
Automatiska säkerhetskopior /DATA/Gallery/immich/backups De 14 senaste dagliga databassäkerhetskopiorna 💡 Finns redan
🎁 Om du bara flyttar fotofilerna – utan katalogen pgdata – får du alla dina foton men inga album, ansiktstaggar, personer, minnen eller delade länkar. Immich betraktar PostgreSQL som den enda sanningskällan. Båda måste flyttas tillsammans.

Immich skapar också automatiskt säkerhetskopior av databasen varje dag kl. 02.00 och behåller de 14 senaste i säkerhetskopieringskatalogen. Innan du kör en manuell dumpning bör du kontrollera om det redan finns en nyligen skapad automatisk säkerhetskopia där.

Metoden: ZimaOS-appen Filer (kopiering via lokalt nätverk)

Båda datorerna kör ZimaOS på samma lokala nätverk. Därför kunde jag använda den inbyggda appen Filer för direkt överföring via det lokala nätverket — inga externa diskar, inga SCP-kommandon och ingen mellanlagring.

Steg 1: Montera källdatorn

På ZimaCube 2 öppnar du appen Filer → + Lägg till lagring → LAN-lagring → anger källdatorns lokala IP-adress och loggar in. Källdatorns filsystem visas nu som bläddringsbar lagring på ZimaCube 2.

Steg 2: Stoppa Immich på källdatorn

Det här är steget som folk hoppar över och ångrar. Stoppa Immich innan du kopierar. En PostgreSQL-instans som kör skriver hela tiden — du måste se till att databasen är i ett konsekvent, renskrivet tillstånd. På källdatorn: ZimaOS App Store → Immich → Stoppa.

Steg 3: Kopiera båda katalogerna

Öppna appen Filer på ZimaCube 2, gå till den monterade källan och välj:

Sökväg till källan Sökväg till målet på ZimaCube 2
/DATA/AppData/immich /DATA/AppData/immich
/DATA/Gallery/immich /DATA/Gallery/immich

Markera båda platserna och klicka på Migrera. Välj: Skriv över på målet och Behåll originalen på källan — radera inte källan förrän du har verifierat.

⚡ Med ZimaCube 2:s 2,5 GbE-anslutning överförs 134 GiB på cirka 10–15 minuter. Min gamla egentillverkade server fastnade på 1 GbE — samma överföring skulle ha tagit 30–40 minuter. Det här är den sortens skillnad i praktiken som inte syns i specifikationsbladet, men som märks varje gång du flyttar data.

Steg 4: Installera Immich på ZimaCube 2

Öppna ZimaOS App Store och sök efter Immich. Viktig varning: App Store kan visa flera Immich-varianter. Du måste installera exakt samma variant som källdatorn använder:

Immich (officiell ZimaOS/CasaOS-app) — använd den här om det är den du hade tidigare

BigBearCasaOS Immich — andra docker-compose-variabler, andra postgres-inloggningsuppgifter, annat databasnamn — inte kompatibel med en direkt kopiering av pgdata från den officiella appen

🔑 docker-compose-variablerna — postgres-användarnamn, lösenord, databasnamn, nätverksläge — är inbäddade i appdefinitionen. Om källans och målets appvarianter inte matchar kan Immich inte ansluta till den återställda databasen. Detta är den absolut vanligaste felkällan vid Immich-migreringar.

Starta inte appen direkt efter installationen. Vid första starten upptäcker Immich den befintliga pgdata-katalogen och ansluter till den i stället för att initiera en ny, tom databas.

Söker efter appen ”immich” i ZimaOS / CasaOS App Store under NAS-installationen

Steg 5: Logga in med befintliga inloggningsuppgifter

Öppna Immich på http://192.168.x.x:2283 och logga in med samma användarnamn och lösenord som på källinstansen. Hela biblioteket — album, ansikten, personer, inställningar — kommer att vara precis som tidigare.

Immichs välkomstskärm och knapp för att komma igång efter en lyckad databasmigrering

Steg 6: Kontrollera jobbköerna

Gå till Profil → Administration → Jobbköer. Efter en pgdata-migrering innehåller databasen redan alla tidigare bearbetade resultat, så de flesta köer bör visa Aktiva: 0 / Väntar: 0.

Om någon kö visar ett antal under Saknas klickar du på knappen Saknas för att bara bearbeta resurser som inte har bearbetats:

Kö När ska saknade jobb köras
Generera miniatyrbilder Om några foton visas med tomma förhandsvisningar
Extrahera metadata Om resurser saknar GPS/plats/datum
Smart sökning Om den semantiska sökningen inte ger några resultat
Ansiktsigenkänning Om ansiktsdata verkar ofullständiga

Migreringsstatistiken

Mätvärde Värde
Foton migrerade 14,505
Videor migrerade 925
Totala data 134 GiB
Överföringstid (2,5 GbE) ~12 minuter
Album bevarade Alla
Ansiktstaggar bevarade Alla
Delade länkar bevarade Alla
Dataförlust Noll

Varför det var värt besväret med ZimaCube 2

Jag migrerade inte bara för att få samma upplevelse. ZimaCube 2 ger tre uppgraderingar som min gamla egentillverkade ZimaOS-dator inte kunde mäta sig med:

2,5 GbE-överföringar. Fotobibliotek växer. Varje fullständig säkerhetskopia, varje stor import och varje migrering drar nytta av 2,5 gånger bandbredden jämfört med vanlig gigabit. ZimaCube 2:s dubbla 2,5 GbE innebär att jag kan maxa en säkerhetskopiering samtidigt som resten av nätverket förblir responsivt.

NVMe-lagring för databasen. Immichs PostgreSQL-databas presterar dramatiskt bättre på NVMe än på snurrande hårddiskar. Skapande av miniatyrbilder, smarta sökfrågor, ansiktsigenkänning — allt läser från pgdata. På ZimaCube 2:s NVMe-pool går databasåtgärder som tidigare hackade på HDD nu direkt.

6 fack för expansion. 134 GiB i dag. Hur ser det ut nästa år? ZimaCube 2 har sex SATA-fack och fyra M.2-platser i det sjunde facket, vilket innebär att det här fotobiblioteket kan växa i flera år utan att lagringsutrymmet tar slut.

IceWhale ZimaCube 2 NAS med sex fack, med främre fack för snabbväxlande hårddiskar för högpresterande, självhostad lagring

Migrera ditt fotobibliotek till ZimaCube 2 →

Bygger du en egen fotolösning? Läs vår guide till personlig molnlagringsenhet, vår djupdykning i Docker och CI/CD på ZimaCube 2 och vår uppackning av ZimaCube 2 Pro.

Vanliga frågor

Kan jag migrera Immich till ZimaCube 2 utan att förlora mina album och ansiktstaggar?

Ja - men du måste kopiera både fotofilerna och pgdata-katalogen (PostgreSQL-databasen). Databasen lagrar alla album, ansiktsvektorer, persongrupper och metadata. Om du bara flyttar fotona får du filer utan organisering. Kopiera båda katalogerna samtidigt så bevaras hela biblioteket.

Vad är det snabbaste sättet att överföra Immich-data till ZimaCube 2?

Om båda datorerna är på samma LAN och kör ZimaOS kan du använda den inbyggda appen Filer med montering av LAN-lagring. Via ZimaCube 2:s 2,5 GbE-anslutning tar det cirka 10–15 minuter att överföra 134 GiB. För större bibliotek eller datorer i olika nätverk är en extern USB-enhet det näst bästa alternativet.

Spelar Immich-versionen i App Store någon roll vid migrering?

Ja - det är avgörande. ZimaOS App Store kan visa flera varianter av Immich (officiell och BigBearCasaOS). De använder olika variabler för docker-compose - uppgifter för postgres, databasnamn och nätverkskonfigurationer är inte kompatibla. Installera exakt samma variant som källdatorn använder, annars kommer den återställda databasen inte att ansluta.

Behöver jag stoppa Immich på källdatorn innan jag kopierar?

Ja. En PostgreSQL-instans som kör skriver kontinuerligt. Om du kopierar en aktiv databas riskerar du att få ett inkonsekvent tillstånd. Stoppa Immich på källdatorn, kopiera mapparna och starta sedan Immich på måldatorn. Källdatorn kan vara avstängd eller fortsätta vara på som säkerhetskopia tills du har verifierat migreringen.

Hur mycket lagringsutrymme behöver Immich på ZimaCube 2?

Planera för storleken på ditt fotobibliotek och lägg till utrymme för PostgreSQL-databasen (som växer i takt med biblioteket), miniatyrbildscache och transkodade videoversioner. Ett bibliotek på 134 GiB med 14 500 foton använder ungefär 150–160 GiB totalt inklusive extrautrymme. De sex SATA-facken i ZimaCube 2 ger dig utrymme att växa.

Zima-kampanjhubben

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.