Een externe schijf koppelen voor Immich op ZimaOS

Als ZimaOS het volgende teruggeeft: mkdir: cannot create directory '/mnt/...': Read-only file systemga er niet van uit dat de externe schijf zelf defect is. In de IceWhale Community-thread van oktober 2025 paste de gebruiker een conventionele Linux- /mnt workflow naar ZimaOS, waar het systeembestandssysteem en de opslagindeling anders worden beheerd.

De belangrijkste les uit de thread is dat u twee taken van elkaar moet scheiden: zorg eerst dat ZimaOS een stabiel hostpad voor de externe HDD heeft en koppel dat hostpad vervolgens aan de Immich-container. Immich kan een pad naar een externe bibliotheek alleen valideren als dat in zijn container bestaat. De huidige Immich-documentatie volgt nog steeds hetzelfde Docker-principe, hoewel het historische containerpad /external_library niet langer specifiek vereist is.

Waarom /mnt alleen-lezen was in de communitycasus

De oorspronkelijke auteur probeerde het volgende te maken:

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

maar ZimaOS gaf het volgende terug:

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

Zima-Giorgio raadde af om ZimaOS-systeembestanden rechtstreeks te wijzigen, tenzij dit onder deskundige begeleiding of in een testomgeving gebeurt. In hetzelfde antwoord werd erop gewezen dat door ZimaOS beheerde schijven en shares normaal gesproken verschijnen onder paden binnen /media en kan deze vanuit de terminal worden weergegeven.

Controleer hoe ZimaOS de schijf al heeft aangekoppeld

Voordat u de koppeling ongedaan maakt of iets bewerkt /etc/fstabBekijk de huidige opslagstatus:

lsblk -f
ls /media
df -h

In de oorspronkelijke thread had ZimaOS de vier schijven al beschikbaar gemaakt via paden die vergelijkbaar waren met:

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

Als de schijf al via ZimaOS is aangekoppeld en stabiel werkt, hoeft u deze mogelijk helemaal niet handmatig opnieuw aan te koppelen. De eenvoudigste Immich-configuratie bestaat vaak uit het gebruik van het bestaande hostpad van ZimaOS als linkerkant van een Docker-volumetoewijzing.

De historische handmatige aankoppelmethode die door de auteur werd gedeeld

De oorspronkelijke auteur documenteerde uiteindelijk een handmatige methode met UUID-gebaseerde /etc/fstab onderstaande vermeldingen en aankoppelpunten /DATA. Bijvoorbeeld:

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

en daarna een /etc/fstab een regel met een echte schijf-UUID:

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

gevolgd door:

sudo systemctl daemon-reload
sudo mount -a

Dit was in 2025 een workaround uit de community voor ZimaOS, geen universele actuele aanbeveling. Kopieer de UUID's of apparaatnamen uit de thread, zoals /dev/sdb; ze behoren tot de hardware van die gebruiker en kunnen veranderen.

Een kleine typefout maakte deel uit van het oorspronkelijke probleem

De auteur ontdekte later dat Apple Notities automatisch de eerste letter van sommige gekopieerde opdrachtregels met een hoofdletter had geschreven. Linux-opdrachten en -paden zijn hoofdlettergevoelig, dus een opdracht die is gekopieerd als Mkdir in plaats van mkdir, of een pad met gewijzigd hoofdlettergebruik, mislukt.

Gebruik bij het voorbereiden van terminalopdrachten een teksteditor zonder opmaak en controleer de hoofdlettergebruik voordat je de opdrachten plakt.

Externe bibliotheken van Immich vereisen twee afzonderlijke stappen

De latere antwoorden verduidelijkten de architectuur:

1. ZimaOS/Docker: koppel het hostpad van de externe harde schijf aan de container immich-server.
2. Immich: maak een externe bibliotheek aan met het pad aan de containerzijde uit stap 1.

Als alleen stap 2 wordt uitgevoerd, mislukt de validatie van Immich omdat het pad niet in de container bestaat.

Het ZimaOS-voorbeeld uit 2025 gebruikte /external_library

Communitylid sny gebruikte conceptueel een koppeling zoals:

ZimaOS-hostpad: /media/USB_1/sny
Immich-pad:      /external_library

Vervolgens voegde de gebruiker in Immich het volgende toe:

/external_library

als importpad voor de externe bibliotheek.

De huidige versie van Immich vereist de naam /external_library niet

De huidige Immich-documentatie is flexibeler. De officiële handleiding voor externe bibliotheken van Immich toont willekeurige host- en containerpaden, bijvoorbeeld:

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

De belangrijkste regel is dat het pad dat je in Immich invoert exact moet overeenkomen met het pad aan de containerzijde. De naam /external_library was een handige conventie in het ZimaOS-communityvoorbeeld, geen vereiste van Immich zelf.

Geef de voorkeur aan alleen-lezenkoppelingen voor archiefbibliotheken

De huidige Immich-documentatie raadt aan :ro wanneer de externe bibliotheek alleen door Immich gelezen moet worden:

/host/photos:/external_library:ro

Verwijder de modus alleen-lezen alleen als je Immich bewust externe assets wilt laten verwijderen of XMP-zijspanmetadata wilt laten schrijven. Een archiefkoppeling in alleen-lezenmodus verkleint het risico dat een toepassing de originele bestanden wijzigt.

Meerdere externe bibliotheken

De community stelde afzonderlijke containerpaden voor, zoals:

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

De huidige versie van Immich ondersteunt ook meerdere koppelpunten. Elk bibliotheekpad moet worden gekoppeld aan immich-server en vervolgens toegevoegd via de beheerpagina Externe bibliotheken van Immich.

Kopieert Immich foto's uit een externe bibliotheek naar de hoofdbibliotheek?

Nee. De huidige Immich-documentatie beschrijft externe bibliotheken als items die op hun oorspronkelijke locatie in het bestandssysteem blijven staan. Immich scant ze, indexeert metadata, maakt databaserecords en afgeleide bestanden zoals miniaturen aan, en toont ze in de tijdlijn.

Als een extern bestand van de schijf verdwijnt, kan Immich het item na een nieuwe scan als ontbrekend markeren of naar de prullenbak verplaatsen. Zorg voor een onafhankelijke back-up van de externe schijf.

Wees voorzichtig met het bewerken van /etc/fstab op ZimaOS

De handmatige methode uit de brondiscussie werkte voldoende om stabiele schijfpaden aan te maken, maar de auteur meldde later aanvullende problemen met USB en migratie. Een ongeldige /etc/fstab vermelding kan ook het opstarten verstoren of opslag ontoegankelijk maken.

Als ZimaOS de schijf al beheert en een stabiel /media/... pad is; gebruik bij voorkeur dat bestaande pad voor de Immich-bindmount in plaats van de opslagindeling van de host onnodig opnieuw op te bouwen.

Checklist voor externe Immich-schijven op ZimaOS

1. Controleer lsblk -f, ls /medianodig hebt; controleer eerst ZimaOS Storage.
2. Ga er niet van uit dat je een traditionele /mnt koppelpunt.
3. Geef de voorkeur aan een door ZimaOS beheerd hostpad als dat al bestaat.
4. Koppel het hostpad aan de immich-server container.
5. Gebruik een duidelijk containerpad, zoals /external_library/photos.
6. Gebruik :ro wanneer Immich alleen een archief hoeft te lezen.
7. Voeg het exacte containerpad toe via Immich-beheer → Externe bibliotheken.
8. Scan de nieuwe bibliotheek en controleer of de taken worden uitgevoerd.
9. Maak onafhankelijk van Immich een back-up van de oorspronkelijke bestanden in de externe bibliotheek.

Veelgestelde vragen over externe Immich-schijven op ZimaOS

Waarom kan ik /mnt/terrabay1 niet aanmaken in ZimaOS?

In het brongeval weigerde het bestandssysteem van ZimaOS daar schrijfbewerkingen. ZimaOS beheerde externe opslag al via de eigen opslagpaden, waaronder paden onder /media.

Moet ik /etc/fstab bewerken?

Niet altijd. De auteur van de bron gebruikte fstab voor een aangepaste, op UUID gebaseerde mountindeling, maar als ZimaOS de schijf al betrouwbaar koppelt, is het eenvoudiger en minder ingrijpend om het bestaande hostpad te gebruiken.

Moet het Immich-pad /external_library zijn?

Nee. Dat was de conventie binnen de ZimaOS-community. De huidige versie van Immich staat willekeurige gekoppelde paden toe, zolang hetzelfde containerpad wordt ingevoerd bij de instellingen van Externe bibliotheek.

Kopieert een externe bibliotheek in Immich mijn originelen?

Nee. De bestanden blijven op hun oorspronkelijke externe locatie staan; Immich indexeert ze en maakt bijbehorende metadata en afgeleide bestanden aan.