Gemenskapslösning

Lägg till ett externt fotobibliotek i Immich på ZimaOS

A ZimaOS user wanted Immich to recognize photos already stored on another drive. The confirmed community solution was to mount that host folder into immich-server and then add the container-side path as an Immich External Library.

Om du redan har foton på en annan HDD eller SSD och vill att Immich på ZimaOS ska indexera dem utan att flytta dem till Immichs vanliga uppladdningsbibliotek använder du ett externt bibliotek. Communitytråden från oktober 2024 bekräftade detta arbetsflöde: exponera först mappen på ZimaOS-värden för containern immich-server och lägg sedan till motsvarande sökväg på containersidan i Immich-administrationen.

Detta skiljer sig från att ändra Immichs primära lagring för uppladdningar. Ett senare svar i samma tråd frågade om den externa disken kunde bli den enda platsen för alla framtida Immich-uppladdningar, men den frågan löstes inte i källtråden. Aktuell Immich-dokumentation behandlar detta som två separata arbetsflöden: externa bibliotek för befintliga filer och UPLOAD_LOCATION/anpassade lagringssökvägar för Immich-hanterade uppladdningar.

Vad den ursprungliga tråden faktiskt löste

Den ursprungliga författaren ville att Immich skulle känna igen foton som lagrades utanför standardplatsen. Senare rapporterade de att följande sekvens fungerade:

  1. Öppna Immich-inställningarna i ZimaOS.
  2. Öppna tjänsten immich-server.
  3. Lägg till mappen på ZimaOS-värden som en Docker-volym.
  4. Använd en sökväg på containersidan, till exempel /home/user/photos1.
  5. Öppna Immich-administrationen.
  6. Skapa ett externt bibliotek och lägg till samma sökväg på containersidan.

En senare användare bekräftade uttryckligen att den här lösningen fungerade för dem.

Sökvägen på värden och Immich-sökvägen är olika

Docker-mappningskonceptet är:

Mapp på ZimaOS-värden → Mapp i Immich-containern

Till exempel:

/media/Photos:/home/user/photos1:ro

Immich genomsöker inte ZimaOS-värdens sökväg direkt. Det kan bara genomsöka sökvägen som är synlig inuti dess container:

/home/user/photos1

Använd skrivskyddat läge för befintliga fotoarkiv

Den ursprungliga lösningen från communityn använde :ro. Aktuell Immich-dokumentation rekommenderar fortfarande skrivskyddade monteringar när Immich endast ska indexera filerna:

/media/Photos:/home/user/photos1:ro

Skrivskyddat läge hindrar Immich från att radera filer eller skriva sidovagnsmetadata i källmappen.

Aktuell dokumentation om externa bibliotek i Immich

Skapa det externa biblioteket i Immich

När monteringen finns öppnar du Immich med ett administratörskonto och går till avsnittet Externa bibliotek. Skapa ett bibliotek, välj dess ägare och lägg till containersökvägen:

/home/user/photos1

Kör sedan en genomsökning. Immich bör börja indexera fotona och skapa jobb för miniatyrbilder och metadata.

Verifiera att sökvägen finns i containern

Om Immich avvisar bibliotekssökvägen, bekräfta att monteringen är synlig för immich-server. Kärnproblemet i källtråden var inte bara att välja en mapp i Immich-gränssnittet; Docker behövde först exponera mappen inuti containern.

Nuvarande Immich-dokumentation gör samma krav uttryckligt: den monterade sökvägen måste finnas i containern innan den kan läggas till som ett externt bibliotek.

Kopiera inte steget för databasfliken blint

I källinlägget från 2024 stod det också att samma sökväg skulle läggas till på fliken Immich Database. Den instruktionen bör hanteras med försiktighet i dag.

Nuvarande uppströmsversion av Immich skiljer mellan:

  • lagring av foton/videor via UPLOAD_LOCATION eller bindmonteringar av externa bibliotek;
  • PostgreSQL-databasslagring via DB_DATA_LOCATION.

Databasens plats är inte samma sak som fotobibliotekets plats. Mappa inte en godtycklig fotomapp till PostgreSQL bara för att det gamla ZimaOS-paketet visade en flik för databastjänsten.

External Library jämfört med Immichs primära lagring

Mål Använd
Indexera foton som redan är lagrade någon annanstans External Library
Låt framtida Immich-uppladdningar sparas på en annan enhet Ändra Immichs uppladdnings-/lagringsplats

Källtråden bekräftade det första fallet, inte det andra.

Om du vill att den externa enheten ska vara Immichs huvudsakliga lagring

Aktuell Immich Docker Compose använder:

UPLOAD_LOCATION=./library

och monterar den värdsökvägen till /data inuti immich-server. Den aktuella dokumentationen om anpassade lagringsplatser förklarar hur du flyttar Immich-hanterade data till en annan värdlagringsplats samtidigt som de förväntade containersökvägarna bevaras.

Anpassade lagringsplatser för Immich

Om viktiga foton redan finns i Immich ska du säkerhetskopiera både databasen och filsystemet innan du ändrar den primära lagringsplatsen.

Håll databasens krav åtskilda

PostgreSQL-databasen har andra lagringskrav än fotofiler. Enligt aktuell Immich-dokumentation stöds inte nätverksresurser för databassökvägen, och databasen bör använda ett lämpligt lokalt filsystem.

Flytta inte PostgreSQL bara för att du lägger till ett externt fotobibliotek.

Externa bibliotek behöver fortfarande separata säkerhetskopior

Immich kopierar inte originalfilerna i det externa biblioteket till sin vanliga hanterade lagring. Originalen ligger kvar på den externa disken. Om filerna tas bort från disken kan Immich markera dem som saknade eller ta bort dem från det aktiva biblioteket efter en ny skanning.

Säkerhetskopiera källenheten separat. Immichs databasm Metadata ersätter inte en säkerhetskopia av filsystemet.

Checklista för Immich External Library på ZimaOS

  1. Identifiera den befintliga ZimaOS-värdmappen som innehåller fotona.
  2. Öppna inställningarna för den aktuella Immich-appen/-containern.
  3. Montera värdmappen i immich-server.
  4. Föredra :ro för ett arkiv som Immich inte ska ändra.
  5. Använd en tydlig containersökväg, till exempel /home/user/photos1 eller /mnt/media/photos.
  6. Öppna Immich Administration → External Libraries.
  7. Lägg till den exakta sökvägen på containersidan.
  8. Kör en biblioteksskanning.
  9. Blanda inte ihop detta med att flytta Immichs primära UPLOAD_LOCATION.
  10. Säkerhetskopiera den externa enheten separat.

Vanliga frågor om Immich External Storage

Fungerade den ursprungliga lösningen?

Ja. Den ursprungliga författaren rapporterade att det fungerade, och en annan användare bekräftade senare att samma arbetsflöde fungerade för dem.

Gör External Library den externa enheten till Immichs huvudsakliga uppladdningsplats?

Nej. Externa bibliotek indexerar filer som redan finns utanför Immichs hanterade uppladdningslagring.

Vilken sökväg ska jag ange i Immich?

Använd sökvägen på containersidan från Docker-monteringen, inte ZimaOS-värdssökvägen.

Ja, när den externa mappen är ett arkiv som Immich endast ska läsa. Ta bort skrivskyddsläget endast om du avsiktligt vill att Immich ska ändra eller ta bort filer där.