Communityoplossing

Verplaats de Immich-fotoopslag naar een NAS of grotere schijf op ZimaOS

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

Immich kan veel opslagruimte gebruiken. Daarom is het voor een groeiende fotobibliotheek zelden ideaal om de uploads, database en machine-learningcache op de systeemschijf van ZimaOS te laten staan.

Deze thread uit 2025 beschrijft een handmatige manier om Immich naar een andere opslaglocatie van ZimaOS te verplaatsen door volumekoppelingen aan de hostzijde te bewerken. Het huidige ZimaOS biedt inmiddels ook directere opties voor opslaglocaties en migratie. De handmatige schermafbeeldingen kunnen daarom het beste worden gezien als uitleg van de manier waarop de containerpaden op elkaar aansluiten.

Open de instellingen van Immich voordat je volumes wijzigt

Immich-appmenu van ZimaOS met de optie Instellingen gemarkeerd voordat opslagvolumes worden gewijzigd
De workflow uit de community begon met het openen van de instellingen van de geïnstalleerde Immich-app, in plaats van mappen blindelings in Bestanden te verplaatsen.

Verplaats het hostpad van de database, niet het containerpad

Volumekoppeling van de Immich-database met een hostpad op /media/Main, terwijl het PostgreSQL-containerpad ongewijzigd blijft
In de werkende configuratie uit de community werd de ZimaOS-kant van de databasetoewijzing gewijzigd, terwijl de bestemming in de PostgreSQL-container ongewijzigd bleef.

Dit onderscheid tussen host en container is cruciaal. De applicatie verwacht specifieke paden binnen de containers. Als je beide kanten wijzigt zonder inzicht in de stack, kan het opstarten mislukken of kan bestaande data onvindbaar lijken.

Ook de machine-learningcache kan op grotere opslag staan

Volumekoppeling van de machine-learningcomponent van Immich, waarbij de modelcache is opgeslagen onder een groter /media-pad op ZimaOS
In het communityvoorbeeld werd de map met de modelcache aan de hostzijde verplaatst, terwijl de verwachte cachebestemming in de container behouden bleef.

Voor het tabblad immich-server is meer zorgvuldigheid nodig

Volumekoppelingen van de Immich-server waarbij het uploadpad en geselecteerde mediamappen worden omgeleid naar opslag onder /media
De auteur van het oorspronkelijke bericht benadrukte dat sommige koppelingen van immich-server moeten worden gewijzigd, terwijl andere exact moeten blijven zoals de applicatie ze verwacht.

Het oorspronkelijke bericht is getest door de community en vormt geen garantie van IceWhale voor elke versie van Immich. De stack van Immich is in de loop der tijd aanzienlijk veranderd. Maak deze exacte volumetabel uit 2025 daarom niet opnieuw aan op een nieuwer pakket zonder eerst de huidige appdefinitie te vergelijken.

Het huidige ZimaOS biedt een directere opslagworkflow

De huidige Immich-instructies voor ZimaOS bieden gebruikers de mogelijkheid om opslaglocaties voor bestanden te wijzigen en beschrijven hoe je Immich-data naar een andere schijf verplaatst via Datamigratie of een gecontroleerde handmatige kopie.

Begin bij een huidige installatie met de huidige opslag- en migratieopties voor Immich, voordat je volumekoppelingen opnieuw opbouwt op basis van een schermafbeelding uit 2025.

Stop Immich eerst als je bestanden handmatig verplaatst

Volgens de huidige richtlijnen van ZimaOS moet je Immich uitschakelen voordat je de Gallery-gegevens handmatig kopieert. Daarna werk je het relevante hostpad bij en start je de applicatie opnieuw. Door schrijfbewerkingen tijdens de verplaatsing te stoppen, verklein je het risico dat je een inconsistente fotobibliotheek kopieert.

Veelgestelde vragen over Immich-opslag op ZimaOS

Kan Immich foto's op een grotere schijf opslaan in plaats van op ZimaOS-HD?

Ja. Zowel het communityvoorbeeld uit 2025 als de huidige Immich-workflow van ZimaOS ondersteunen het gebruik van een andere opslaglocatie.

Moet ik het PostgreSQL-pad aan de containerzijde wijzigen?

Niet volgens de beschreven workflow. Het opslagpad aan de hostzijde werd gewijzigd, terwijl het applicatiepad in de container de verwachte PostgreSQL-locatie bleef.

Moet ik alle vier de tabbladen uit 2025 exact volgen?

Nee. Beschouw ze als historische voorbeelden van de containerindeling. Vergelijk ze met het huidige Immich-pakket voordat je iets wijzigt.

Is er inmiddels een ingebouwde migratieoptie?

In de huidige richtlijnen voor Immich op ZimaOS worden zowel Datamigratie als een gecontroleerde handmatige verplaatsing van Immich-data beschreven.