Monta un’unità esterna per Immich su ZimaOS

Se ZimaOS restituisce mkdir: impossibile creare la directory '/mnt/...': file system di sola lettura, non presumere che il disco esterno sia guasto. Nella discussione della community IceWhale dell'ottobre 2025, l'utente stava applicando un /mnt flusso di lavoro verso ZimaOS, dove il file system di sistema e la disposizione dello storage sono gestiti in modo diverso.

La lezione più importante della discussione è separare due attività: prima assicurarsi che ZimaOS disponga di un percorso host stabile per il disco rigido esterno, quindi mappare quel percorso nel container Immich. Immich può convalidare un percorso di libreria esterna solo se esiste all'interno del container. La documentazione attuale di Immich segue ancora lo stesso principio Docker, anche se non richiede più specificamente il percorso del container storico /external_library.

Perché /mnt era di sola lettura nel caso della community

L'autore originale ha provato a creare:

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

ma ZimaOS ha restituito:

mkdir: impossibile creare la directory '/mnt/terrabay4': file system di sola lettura

Zima-Giorgio ha sconsigliato di modificare direttamente i file di sistema di ZimaOS, salvo che ciò avvenga sotto la guida di un esperto o in un ambiente di test. La stessa risposta ha sottolineato che le unità e le condivisioni gestite da ZimaOS normalmente compaiono in percorsi sotto /media e può essere elencato dal terminale.

Verifica come ZimaOS ha già montato l'unità

Prima di smontare o modificare /etc/fstab, ispeziona lo stato attuale dello storage:

lsblk -f
ls /media
df -h

Nella discussione originale, ZimaOS aveva già esposto i quattro dischi tramite percorsi simili a:

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

Se l'unità è già montata e funziona stabilmente tramite ZimaOS, potrebbe non essere affatto necessario rimontarla manualmente. Spesso, la configurazione più semplice di Immich consiste nell'utilizzare il percorso host già esistente di ZimaOS come lato sinistro della mappatura di un volume Docker.

Il metodo storico di montaggio manuale condiviso dall'autore

L'autore originale alla fine ha documentato un metodo manuale utilizzando gli UUID /etc/fstab le voci e i punti di montaggio riportati di seguito /DATA. Ad esempio:

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

e poi un comando /etc/fstab riga utilizzando l'UUID reale di un disco:

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

seguito da:

sudo systemctl daemon-reload
sudo mount -a

Questa era una soluzione alternativa della community per ZimaOS nel 2025, non una raccomandazione universale attuale. Non copiare gli UUID o i nomi dei dispositivi della discussione, come /dev/sdb; appartengono all'hardware di quell'utente e possono cambiare.

Un semplice errore di digitazione faceva parte del problema originale

L'autore ha scoperto in seguito che Apple Notes aveva automaticamente trasformato in maiuscola il primo carattere di alcune righe di comando copiate. I comandi e i percorsi Linux distinguono tra maiuscole e minuscole, quindi un comando copiato come Mkdir invece di mkdir, oppure un percorso con maiuscole modificate, fallirà.

Quando prepari i comandi nel terminale, usa un editor di testo semplice e verifica le maiuscole prima di incollare.

Le librerie esterne di Immich richiedono due passaggi separati

Le risposte successive hanno chiarito l'architettura:

1. ZimaOS/Docker: mappa il percorso host del disco rigido esterno nel container immich-server.
2. Immich: crea una libreria esterna utilizzando il percorso all'interno del container indicato nel passaggio 1.

Se viene eseguito solo il passaggio 2, la convalida di Immich fallisce perché il percorso non esiste all'interno del suo container.

L'esempio ZimaOS del 2025 utilizzava /external_library

Il membro della community sny ha usato concettualmente una mappatura simile:

Percorso host ZimaOS: /media/USB_1/sny
Percorso Immich:      /external_library

Poi, in Immich, l'utente ha aggiunto:

/external_library

come percorso di importazione della libreria esterna.

L'attuale Immich non richiede il nome /external_library

L'attuale documentazione di Immich è più flessibile. La sua guida ufficiale alle librerie esterne mostra percorsi host e container arbitrari, ad esempio:

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

La regola importante è che il percorso inserito in Immich deve corrispondere esattamente al percorso all'interno del container. Il nome /external_library era una convenzione pratica nell'esempio della community ZimaOS, non un requisito di Immich upstream.

Preferisci mount in sola lettura per le librerie di archivio

L'attuale documentazione di Immich consiglia di aggiungere :ro quando la libreria esterna deve essere solo letta da Immich:

/host/photos:/external_library:ro

Rimuovi la modalità di sola lettura solo se vuoi intenzionalmente che Immich elimini risorse esterne o scriva metadati XMP sidecar. Un mount di archivio in sola lettura riduce il rischio che un'applicazione modifichi i file originali.

Più librerie esterne

La community ha suggerito percorsi separati per i container, come:

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

Le versioni attuali di Immich supportano anche più punti di montaggio. Il percorso di ogni libreria deve essere montato in immich-server e poi aggiunto nella pagina di amministrazione Librerie esterne di Immich.

Immich copia le foto della libreria esterna nella libreria principale?

No. La documentazione attuale di Immich descrive le librerie esterne come elementi che rimangono nella posizione originale del file system. Immich li scansiona, indicizza i metadati, crea record nel database e risorse derivate come le miniature, quindi li mostra nella timeline.

Se un file esterno scompare dal disco, dopo una nuova scansione Immich può contrassegnare l'elemento come mancante o spostarlo nel cestino. Mantieni il backup dell'unità esterna separato.

Fai attenzione quando modifichi /etc/fstab su ZimaOS

Il metodo manuale della discussione originale ha funzionato abbastanza da creare percorsi stabili per le unità, ma l'autore ha in seguito segnalato ulteriori problemi con USB e migrazioni. Una voce non valida in /etc/fstab una voce può inoltre interferire con l'avvio o rendere lo spazio di archiviazione indisponibile.

Se ZimaOS gestisce già il disco ed espone un /media/... percorso, preferisci usare quello esistente per il bind mount di Immich invece di ricostruire inutilmente la configurazione di archiviazione dell'host.

Checklist per un'unità esterna di Immich su ZimaOS

1. Controlla lsblk -f, ls /media, e prima l'archiviazione di ZimaOS.
2. Non dare per scontato di dover usare un tradizionale /mnt punto di montaggio.
3. Preferisci un percorso host gestito da ZimaOS quando ne esiste già uno.
4. Mappa il percorso host nel immich-server container.
5. Usa un percorso del container chiaro, ad esempio /external_library/photos.
6. Usa :ro quando Immich deve solo leggere un archivio.
7. Aggiungi il percorso esatto del container in Amministrazione di Immich → Librerie esterne.
8. Scansiona la nuova libreria e verifica che i processi siano in esecuzione.
9. Esegui il backup indipendente dei file originali della libreria esterna, senza affidarti a Immich.

Domande frequenti sull'unità esterna di Immich su ZimaOS

Perché non riesco a creare /mnt/terrabay1 su ZimaOS?

Nel caso della fonte, il file system di sistema di ZimaOS rifiutava le scritture in quella posizione. ZimaOS gestiva già lo spazio di archiviazione esterno tramite i propri percorsi, inclusi quelli sotto /media.

Devo modificare /etc/fstab?

Non sempre. L'autore della fonte usava fstab per una configurazione di montaggio personalizzata basata sull'UUID, ma se ZimaOS monta già l'unità in modo affidabile, usare il percorso host esistente è più semplice e meno invasivo.

Il percorso di Immich deve essere /external_library?

No. Questa era la convenzione della community di ZimaOS. Le versioni attuali di Immich consentono percorsi montati arbitrari, purché nelle impostazioni della libreria esterna venga inserito lo stesso percorso del container.

Una libreria esterna di Immich copia i miei originali?

No. I file rimangono nella loro posizione esterna originale; Immich li indicizza e crea i metadati associati e gli elementi derivati.