Immich installeren op Synology met Container Manager
Immich geeft je een eigen fotobibliotheek met mobiele back-up en slimme zoekfuncties. Op een geschikte Synology NAS kun je Immich als Docker Compose-project draaien via Container Manager.
Wat heb je nodig?
- een Synology-model waarop Container Manager beschikbaar is;
- voldoende vrije opslagruimte voor je foto's én database;
- bij voorkeur minimaal enkele gigabytes RAM; voor grote bibliotheken en machine learning is meer prettiger;
- toegang tot DSM met voldoende rechten;
- een back-upstrategie voor je foto's en database.
1. Installeer Container Manager
Open Pakketcentrum in DSM en controleer of Container Manager beschikbaar is voor jouw NAS. Installeer het pakket en open het daarna.
Container Manager kan projecten met meerdere containers via Docker Compose beheren. Dat is precies wat Immich nodig heeft.
2. Maak de Immich-mappen
Maak in File Station een vaste map voor de installatie. Een logische indeling is bijvoorbeeld:
docker/
└── immich-app/
├── library/
└── postgres/De map library is voor je fotobibliotheek en postgres voor de databasegegevens. Gebruik duidelijke, vaste locaties zodat je later weet wat je moet back-uppen.
3. Download de actuele Immich-bestanden
Download vanaf de actuele Immich-documentatie het officiële docker-compose.yml-bestand en het voorbeeldbestand voor de environment variables. Upload beide naar je map docker/immich-app.
Hernoem het voorbeeldbestand daarna naar .env. Gebruik niet zomaar een Compose-bestand uit een oude blogpost: Immich ontwikkelt snel en de aanbevolen configuratie kan veranderen.
4. Pas het .env-bestand aan
In .env geef je onder andere aan waar je bibliotheek en database moeten staan. Controleer de paden zorgvuldig en gebruik een sterk databasewachtwoord.
Bewaar dit bestand. Zonder de juiste environment variables kan een later opnieuw gebouwde installatie niet meer op dezelfde manier starten.
5. Maak in Container Manager een project
Ga naar Container Manager → Project → Maken. Geef het project bijvoorbeeld de naam immich-app en selecteer de map waarin je docker-compose.yml staat.
Container Manager herkent het Compose-bestand in de gekozen projectmap. Controleer de configuratie en laat het project daarna bouwen en starten.
6. Wacht tot alle containers draaien
Immich bestaat uit meerdere onderdelen. Controleer na de eerste build of de server, database, cache en machine-learningonderdelen daadwerkelijk actief blijven.
Stopt één onderdeel direct? Open dan de logs. Begin niet meteen opnieuw; de eerste foutmelding geeft meestal aan of het om een pad, wachtwoord, database of rechtenprobleem gaat.
7. Open Immich in je browser
De standaardwebpoort die in de huidige Immich Compose-installatie wordt gebruikt is doorgaans 2283. Open bijvoorbeeld:
http://IP-VAN-JE-NAS:2283Gebruik het poortnummer uit jouw actuele Compose-bestand als dat afwijkt.
8. Synology-firewall actief? Voeg een regel toe
Als de containers draaien maar de webinterface niet opent, kan de DSM-firewall verkeer blokkeren. De Immich-communityhandleiding voor Synology beschrijft daarom een firewallregel voor de gebruikte poort en, afhankelijk van je netwerkconfiguratie, het Docker-netwerk.
Gebruik je een vaste Docker-subnetconfiguratie, dan voorkom je dat een firewallregel na een rebuild ineens naar een oud containeradres wijst.
9. Stel de telefoon-app in
Installeer de Immich-app op je telefoon en vul het adres van je server in. Test eerst met een paar foto's voordat je een complete fotobibliotheek laat uploaden.
Controleer ook hoe je bestaande foto's zijn georganiseerd. Immich is geen vervanging voor een echte back-up: zorg ervoor dat belangrijke foto's nog op minstens één andere locatie bestaan.
10. Maak vóór grote updates een back-up
Een update van Immich kan meerdere containers en de database raken. Controleer daarom eerst de release notes en maak een back-up van je fotobibliotheek en database voordat je een grote versie-update uitvoert.
De huidige Synology-communityroute voor updates is in grote lijnen: project stoppen, gecontroleerd opschonen, nieuwe images ophalen/bouwen en daarna controleren of firewall en netwerk nog kloppen. Volg hiervoor altijd de actuele Immich-documentatie, omdat updateprocedures kunnen wijzigen.
Veelvoorkomende problemen
Immich-server start en stopt direct
Kijk eerst naar de logs. Controleer daarna databaseverbinding, .env, opslagpaden en rechten.
Webpagina opent niet
Controleer poort 2283, DSM-firewall, het IP-adres van de NAS en eventuele reverse proxy.
Machine learning maakt de NAS traag
Gezichtsherkenning en andere AI-taken kunnen veel CPU en RAM gebruiken. Laat grote eerste analyses desnoods 's nachts draaien en houd het resourcegebruik in Container Manager in de gaten.
Na een update werkt de firewallregel niet meer
Een dynamisch Docker-netwerk kan na een rebuild veranderen. Een vaste subnetconfiguratie kan dit voorkomen, maar pas netwerkconfiguratie alleen aan als je begrijpt welke adressen je gebruikt.
Welke Synology is geschikt voor Immich?
Voor een kleine bibliotheek kan een bescheiden Plus-model voldoende zijn. Voor veel foto's, machine learning en meerdere containers tegelijk zijn uitbreidbaar RAM en een sterkere processor prettiger. Gebruik onze NAS-database en filter op Immich om modellen te vergelijken.