Kort gezegd: plaats de database van Immich op een lokale Unix-compatibele SSD en koppel de USB-harde schijf als media
De situatie in 2025 werd verwarrend omdat “gebruik de externe harde schijf voor Immich” twee heel verschillende dingen kan betekenen. De PostgreSQL-database van Immich stelt strenge eisen aan het bestandssysteem. Bestaande foto's op een USB-harde schijf kun je beter als externe bibliotheek koppelen, terwijl de database op stabiele lokale SSD-opslag blijft staan.
Plaats de PostgreSQL-database van Immich niet op NTFS, exFAT of een netwerkshare
De huidige vereisten van Immich vermelden expliciet dat de PostgreSQL-gegevensdirectory bij voorkeur op lokale SSD-opslag staat en een bestandssysteem moet gebruiken dat Unix-eigenaarschap en -rechten ondersteunt. NTFS en exFAT worden niet ondersteund voor de database. Zie de databasevereisten van Immich.
De externe opslag van Immich vertaalt dit ontwerp naar ZimaOS.
Gebruik de USB-harde schijf als externe bibliotheek als de foto's daar al staan
Koppel het echte hostpad van ZimaOS aan immich-server, bij voorkeur alleen-lezen voor archiefmedia:
/media/YourUSB/Photos:/external_library:roVoeg vervolgens /external_library toe in Immich. De exacte naam aan de containerzijde kan anders zijn; deze hoeft alleen overeen te komen met het pad dat de container daadwerkelijk ziet. De documentatie over externe bibliotheken van Immich beschrijft deze regel.
Waarom één installatie kan werken en de volgende kan mislukken
De containertoestand, oude volumes, onjuiste hostpaden en databasemappen kunnen tussen pogingen behouden blijven of veranderen. Controleer de daadwerkelijke koppelingen en logboeken voordat je herhaaldelijk opnieuw installeert:
docker ps -a
docker logs --tail=200 immich_server
lsblk -fDe app-paden van ZimaOS helpen het hostpad van ZimaOS te onderscheiden van het pad dat binnen Immich zichtbaar is.
Beschouw het oude antwoord “upgrade naar 1.5.0 en het werkt” niet als de oplossing
Een update van ZimaOS verbeterde de USB-ondersteuning, maar de oorspronkelijke auteur reproduceerde de fout later opnieuw, zelfs na een geslaagde aangepaste installatie. Dat bewijst dat alleen de versie niet voldoende was. De huidige installatie moet worden gecontroleerd aan de hand van de opslagindeling, het koppelingspad, de databaselocatie en de containerlogboeken.
Een stabiele indeling voor fotoarchieven op USB
- Appgegevens van ZimaOS/Immich: SSD.
- PostgreSQL-database van Immich: lokale Unix-compatibele SSD.
- Bestaand fotoarchief: USB-harde schijf gekoppeld als externe bibliotheek.
- Onafhankelijke back-up: een andere schijf of externe back-uplocatie.
De back-up van ZimaOS dekt de laatste laag af.
