Montera en extern enhet för Immich på ZimaOS

Om ZimaOS returnerar mkdir: cannot create directory '/mnt/...': Read-only file system, anta inte att den externa disken i sig är trasig. I IceWhale Community-tråden från oktober 2025 använde användaren ett konventionellt Linux- /mnt arbetsflöde till ZimaOS, där systemfilsystemet och lagringslayouten hanteras annorlunda.

Den viktigaste lärdomen från tråden är att skilja på två uppgifter: se först till att ZimaOS har en stabil värdsökväg för den externa hårddisken och mappa sedan den värdsökvägen till Immich-containern. Immich kan bara validera en extern bibliotekssökväg som finns inuti dess container. Den aktuella Immich-dokumentationen följer fortfarande samma Docker-princip, även om den inte längre kräver den historiska containersökvägen /external_library specifikt.

Varför /mnt var skrivskyddad i communityfallet

Den ursprungliga författaren försökte skapa:

/mnt/terrabay1
/mnt/terrabay2
/mnt/terrabay3
/mnt/terrabay4

men ZimaOS returnerade:

mkdir: cannot create directory '/mnt/terrabay4': Read-only file system

Zima-Giorgio avrådde från att direkt ändra ZimaOS-systemfiler om det inte sker under expertvägledning eller i en testmiljö. Samma svar påpekade att enheter och utdelningar som hanteras av ZimaOS normalt visas under sökvägar nedanför /media och kan listas från terminalen.

Kontrollera hur ZimaOS redan har monterat enheten

Innan du avmonterar eller redigerar /etc/fstab, kontrollera det aktuella lagringstillståndet:

lsblk -f
ls /media
df -h

I källtråden hade ZimaOS redan exponerat de fyra diskarna via sökvägar som liknade:

/media/sdb-ata-ST2000VN003-3CW1
/media/sdc-ata-ST2000VN003-3CW1

Om enheten redan är monterad och fungerar stabilt via ZimaOS behöver du kanske inte montera den manuellt igen alls. Den enklaste Immich-konfigurationen är ofta att använda den befintliga värdsökvägen i ZimaOS som vänster sida i en Docker-volymmappning.

Den historiska manuella monteringsmetoden som författaren delade

Den ursprungliga författaren dokumenterade så småningom en manuell metod med UUID-baserade /etc/fstab poster och monteringspunkter nedan /DATA. Till exempel:

sudo mkdir -p /DATA/Enclosure/Bay1
sudo mount /dev/sdb /DATA/Enclosure/Bay1

och sedan ett /etc/fstab rad med ett riktigt disk-UUID:

UUID=YOUR-REAL-UUID /DATA/Enclosure/Bay1 ext4 defaults,nofail,x-systemd.automount 0 0

följt av:

sudo systemctl daemon-reload
sudo mount -a

Detta var en lösning från communityn i ZimaOS 2025, inte en universell aktuell rekommendation. Kopiera inte trådens UUID:er eller enhetsnamn som /dev/sdb; de tillhör den användarens maskinvara och kan ändras.

Ett litet skrivfel var en del av det ursprungliga problemet

Författaren upptäckte senare att Apple Notes automatiskt hade versaliserat den första bokstaven i vissa kopierade kommandorader. Linux-kommandon och sökvägar är skiftlägeskänsliga, så ett kommando som kopierats som Mkdir i stället för mkdir, eller en sökväg med ändrad versalisering, kommer att misslyckas.

När du förbereder terminalkommandon ska du använda en vanlig textredigerare och kontrollera versalerna innan du klistrar in dem.

Externa Immich-bibliotek kräver två separata steg

De senare svaren klargjorde arkitekturen:

1. ZimaOS/Docker: mappa den externa hårddiskens värdsökväg till containern immich-server.
2. Immich: skapa ett externt bibliotek med sökvägen på containersidan från steg 1.

Om endast steg 2 utförs misslyckas Immichs validering eftersom sökvägen inte finns inuti containern.

ZimaOS-exemplet från 2025 använde /external_library

Communitymedlemmen sny använde ett konceptuellt liknande mappningsupplägg:

ZimaOS-värdsökväg: /media/USB_1/sny
Immich-sökväg:      /external_library

Sedan lade användaren till följande i Immich:

/external_library

som import sökväg för det externa biblioteket.

Aktuella Immich kräver inte namnet /external_library

Den aktuella Immich-dokumentationen är mer flexibel. Den officiella guiden till externa bibliotek visar godtyckliga värd- och containersökvägar, till exempel:

immich-server:
  volumes:
    - /home/user/photos1:/home/user/photos1:ro
    - /mnt/photos2:/mnt/photos2:ro

Den viktiga regeln är att sökvägen som anges i Immich måste matcha sökvägen på containersidan exakt. Namnet /external_library var en praktisk konvention i ZimaOS-communityexemplet, inte ett krav från Immich-projektet.

Föredra skrivskyddade monteringar för arkivbibliotek

Den aktuella Immich-dokumentationen rekommenderar att lägga till :ro när det externa biblioteket endast ska läsas av Immich:

/host/photos:/external_library:ro

Ta endast bort skrivskyddat läge om du avsiktligt vill att Immich ska ta bort externa resurser eller skriva XMP-sidovagnsmetadata. En skrivskyddad arkivmontering minskar risken för att ett program ändrar originalfilerna.

Flera externa bibliotek

Communityn föreslog separata containersökvägar, till exempel:

/external_library/usb1
/external_library/usb2
/external_library/photos

Den aktuella versionen av Immich stöder även flera monteringspunkter. Varje bibliotekssökväg måste monteras in i immich-server och läggs sedan till på administrationssidan för Immichs externa bibliotek.

Kopierar Immich foton från externa bibliotek till sitt huvudbibliotek?

Nej. Den aktuella Immich-dokumentationen beskriver externa bibliotek som tillgångar som ligger kvar på sin ursprungliga filsystemsplats. Immich skannar dem, indexerar metadata, skapar databasposter och härledda tillgångar som miniatyrbilder och visar dem i tidslinjen.

Om en extern fil försvinner från disken kan Immich markera tillgången som saknad eller flytta den till papperskorgen efter en ny skanning. Säkerhetskopiera den externa enheten separat.

Var försiktig när du redigerar /etc/fstab på ZimaOS

Källtrådens manuella metod fungerade tillräckligt bra för att skapa stabila enhetssökvägar, men författaren rapporterade senare ytterligare problem med USB och migrering. En ogiltig /etc/fstab post kan också störa uppstarten eller göra lagringen otillgänglig.

Om ZimaOS redan hanterar disken och tillhandahåller en stabil /media/... sökväg, och använd helst den befintliga sökvägen för Immichs bind-montering i stället för att bygga om värdens lagringslayout i onödan.

Checklista för Immich External Drive på ZimaOS

1. Kontrollera lsblk -f, ls /media, och ZimaOS Storage först.
2. Anta inte att du behöver en traditionell /mnt monteringspunkt.
3. Föredra en värdsökväg som hanteras av ZimaOS när en sådan redan finns.
4. Mappa värdsökvägen till immich-server container.
5. Använd en tydlig containersökväg, till exempel /external_library/photos.
6. Använd :ro när Immich bara behöver läsa ett arkiv.
7. Lägg till den exakta containersökvägen under Immich Administration → Externa bibliotek.
8. Skanna det nya biblioteket och kontrollera att jobben körs.
9. Säkerhetskopiera filer i externa bibliotek separat från Immich.

Vanliga frågor om Immich External Drive på ZimaOS

Varför kan jag inte skapa /mnt/terrabay1 i ZimaOS?

I källfallet nekade ZimaOS systemfilsystem skrivningar där. ZimaOS hanterade redan extern lagring via sina egna lagringssökvägar, inklusive sökvägar under /media.

Behöver jag redigera /etc/fstab?

Inte alltid. Källförfattaren använde fstab för en anpassad UUID-baserad monteringslayout, men om ZimaOS redan monterar enheten på ett tillförlitligt sätt är det enklare och mindre ingripande att använda den befintliga värdsökvägen.

Måste Immich-sökvägen vara /external_library?

Nej. Det var ZimaOS-communityts konvention. Den aktuella versionen av Immich tillåter godtyckliga monterade sökvägar så länge samma containersökväg anges i inställningarna för externa bibliotek.

Kopierar ett externt Immich-bibliotek mina original?

Nej. Filerna ligger kvar på sin ursprungliga externa plats; Immich indexerar dem och skapar tillhörande metadata och härledda tillgångar.