Immich zelf hosten: 6 GB RAM en veilige updates

Wat u bouwt

Immich is een zelfgehoste back-upservice voor foto's en video's, een volwaardig alternatief voor Google Photos. Het bevat een mobiele app die uw filmrol op de achtergrond uploadt, een tijdlijn, albums, gezichtsherkenning en zoekfuncties op basis van machine learning die "strand" of een persoon vindt zonder dat u zelf iets hoeft te taggen. U draait het op een VPS in eigen beheer, de originele bestanden blijven op uw schijf staan en niemand scant ze om u advertenties te tonen. Als u nog twijfelt tussen de verschillende opties, vergelijkt onze vergelijking tussen PhotoPrism en Immich hun RAM-gebruik, mobiele apps en back-upcommando's.

De installatie bestaat uit vier containers op basis van het Docker Compose-bestand van het project zelf. Dat deel kost tien minuten. De rest van deze handleiding behandelt de uitdagende aspecten: de machine-learning-container verbruikt veel geheugen op een kleine server, originele bestanden nemen snel schijfruimte in beslag, de mobiele app vereist de exacte server-URL en u wilt HTTPS configureren voordat de verbinding uw netwerk verlaat. Bovendien brengt Immich regelmatig ingrijpende wijzigingen uit, waardoor een ondoordachte docker compose pull ertoe kan leiden dat uw server niet meer opstart. Neem deze vier punten serieus en Immich is uiterst stabiel. Negeert u ze, dan kost het u een heel weekend.

Vereisten en de eerlijke valkuilen

• RAM: de officiële documentatie vermeldt 6 GB als minimum en 8 GB als aanbevolen, beschouw 4 GB plus swap als de absolute ondergrens. De immich-server- en Postgres-containers zijn bescheiden. De immich-machine-learning-container is de grootste verbruiker; deze laadt CLIP- en gezichtsherkenningsmodellen in het RAM om zoekindexen op te bouwen. Op een systeem met 2 GB beëindigt de kernel het proces. Voeg swap toe, zelfs als u 4 GB RAM heeft.
• Schijfruimte: reserveer ruimte voor uw volledige bibliotheek, plus extra. Uw originelen worden volledig gekopieerd en Immich genereert daarnaast miniaturen en voorbeeldafbeeldingen (ongeveer 10–20% extra). Een fotocollectie van 200 GB vereist een volume van 300 GB. Postgres is in vergelijking hiermee klein.
• CPU: elke moderne KVM VPS volstaat, maar machine learning op de CPU is traag. Het indexeren van een grote import voor slim zoeken kan uren op de achtergrond draaien. Dit is normaal; een GPU is niet vereist.
• Een domeinnaam die naar de VPS wijst. De mobiele app werkt bij voorkeur met een HTTPS-eindpunt en u heeft een reverse proxy nodig. Dit is dezelfde opzet als een zelfgehoste Nextcloud-instantie met Docker, TLS en back-ups; Immich is de tegenhanger voor foto's van die bestandsserver.
• Docker en de Compose-plugin geïnstalleerd; Docker Engine plus de Compose v2-plugin uit de officiële apt-repository van Docker, precies zoals behandeld in onze handleiding voor Docker Compose-basisprincipes.

Stap 1: Voeg swap toe voordat u verdergaat

De meest voorkomende reden voor het falen van Immich op een kleine VPS is dat de ML-container wordt beëindigd door de OOM-killer (Out of Memory). Geef de kernel eerst wat ademruimte.

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -h

free -h zou nu een Swap:-regel van 4.0Gi moeten tonen. Dit maakt ML niet sneller en het is een buffer in plaats van een garantie, maar het verkleint de kans aanzienlijk dat de container tijdens het indexeren crasht op een machine met 4 GB RAM.

Stap 2: Haal de officiële compose en env op, gebruik die van hen, geen kopie

Immich zet zijn serviceversies en, cruciaal, zijn database-image vast in de bestanden die het meelevert. Kopieer geen compose-bestand van een blog (inclusief deze) als uw bron van waarheid. Download de release-assets:

sudo mkdir -p /opt/immich && cd /opt/immich
sudo wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
sudo wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Deze zijn afkomstig van de getagde release, waardoor de image-verwijzingen overeenkomen. Het compose-bestand definieert vier services, en het is nuttig om te weten wat elk daarvan is voordat u wijzigingen aanbrengt:

• immich-server (ghcr.io/immich-app/immich-server, container immich_server), de API en web-UI, luisterend op poort 2283. Deze koppelt uw uploads aan /data.
• immich-machine-learning (ghcr.io/immich-app/immich-machine-learning, container immich_machine_learning), CLIP-zoekfunctie en gezichtsherkenning. Cacht gedownloade modellen in een model-cache-volume. Dit is de service die veel geheugen verbruikt.
• database (container immich_postgres), Postgres met de VectorChord vector-extensie, die de gelijkeniszoekopdrachten aandrijft. De image-tag is vastgezet via een digest direct in het compose-bestand, bijvoorbeeld ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:.... Oudere installaties gebruikten pgvecto.rs; ondersteuning hiervoor is verwijderd in Immich v3.0, dus alles wat u vandaag installeert is VectorChord. Pas deze tag nooit handmatig aan.
• redis (container immich_redis), een Valkey/Redis-instantie voor wachtrijen van taken.

Stap 3: Configureer .env, waar uw foto's en database zich bevinden

Open .env en stel vier zaken in. Alles onder de gemarkeerde regel blijft ongewijzigd.

# Where original uploads are stored on the host
UPLOAD_LOCATION=/opt/immich/library

# Where the Postgres data lives. NEVER put this on an NFS/network share.
DB_DATA_LOCATION=/opt/immich/postgres

# "v3" is a floating tag that tracks the latest v3.x. Pin a full tag like
# v3.0.2 instead; then you upgrade on purpose, not by surprise.
IMMICH_VERSION=v3.0.2

# Change this to a long random string. Letters and digits only.
DB_PASSWORD=REPLACE_WITH_A_LONG_RANDOM_STRING

# Set your timezone so timestamps and "on this day" line up
TZ=Europe/London

###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

Twee regels die u veel ellende besparen. UPLOAD_LOCATION moet naar uw grote schijf wijzen. Als u later een datavolume koppelt, stel dit dan vanaf het begin in op het koppelpunt; achteraf verplaatsen betekent dat u thumbnails moet verplaatsen en asset-paden moet bijwerken. En DB_DATA_LOCATION moet op een lokale schijf staan: Postgres op een NFS- of SMB-share raakt corrupt, en de documentatie stelt dit expliciet. Als u alleen letters en cijfers gebruikt in DB_PASSWORD, vermijdt u een categorie bugs met betrekking tot het escapen van connection strings.

Stap 4: Eerste uitvoering en aanmaken van de beheerder

cd /opt/immich
sudo docker compose up -d
sudo docker compose ps

Een correct resultaat bestaat uit vier containers, die allemaal running zijn en uiteindelijk healthy:

NAME                      STATUS
immich_machine_learning   Up (healthy)
immich_postgres           Up (healthy)
immich_redis              Up (healthy)
immich_server             Up (healthy)

De eerste up haalt enkele gigabytes aan images op, dus geef dit de tijd. Volg de voortgang met sudo docker compose logs -f immich-server; de server logt dat deze luistert op poort 2283 zodra deze gereed is. Open nu http://YOUR_SERVER_IP:2283 in een browser. Bij het eerste bezoek verschijnt een Getting Started-wizard; het eerste account dat u aanmaakt is de beheerder. Stel een sterk wachtwoord in; dit account beheert de serverinstellingen, het gebruikersbeheer en de ML-configuratie die u later nodig zult hebben.

Stap 5: De mobiele app en achtergrondback-up

Installeer "Immich" vanuit de App Store of Play Store. Op het inlogscherm wordt gevraagd om een Server Endpoint URL. Voer de volledige URL in, inclusief het schema, bijvoorbeeld https://photos.example.com (de app voegt /api zelf toe). Log in met het account dat u zojuist heeft aangemaakt, open vervolgens het Backup-scherm van de app, selecteer de albums die u wilt beveiligen (meestal Camera en Screenshots) en schakel Background backup in. Achtergrondback-ups op iOS worden door het besturingssysteem beperkt; uploads op de voorgrond worden altijd uitgevoerd, terwijl achtergrond-uploads plaatsvinden wanneer het besturingssysteem dit toestaat.

Dit is precies het punt waar gebruikers vaak vastlopen, dus lees Stap 6 voordat u problemen met de app probeert op te lossen.

Stap 6: HTTPS via een reverse proxy en de volledige URL-regel

De mobiele app vereist HTTPS zodra deze uw thuisnetwerk verlaat. Plaats een reverse proxy voor poort 2283 en beëindig daar de TLS-verbinding. Als u al meerdere containers draait, is Traefik met automatische TLS voor meerdere Docker-apps de meest overzichtelijke optie; één labelblok routeert photos.example.com naar de immich-server-container en haalt automatisch het certificaat voor u op. Als u de voorkeur geeft aan nginx, helpt de handleiding Let's Encrypt met Certbot en nginx u bij het verkrijgen van een certificaat en een proxy_pass http://127.0.0.1:2283;-blok. Zodra die proxy actief is, is het toevoegen van de volgende service meestal niet meer dan een nieuw subdomein. Zo kan een media-frontend zoals Halcyon, de 90s video store skin voor Jellyfin naast Immich op dezelfde server draaien. Hetzelfde geldt voor een zelfgehoste HarnessRouter die Codex en Claude Code achter één API plaatst; deze bindt bewust aan loopback en is pas bereikbaar zodra de proxy de TLS-verbinding ervoor beëindigt. Wijzig daarom de standaard login voordat u er een subdomein aan koppelt. Niet elke container heeft echter een publieke hostnaam nodig: een tool voor alleen beheerders, zoals een zelfgehoste open-kritt security scanner, kunt u beter volledig buiten de proxy houden en alleen benaderen via een SSH-tunnel op de zeldzame momenten dat u de UI opent. Andere services slaan de proxy over omdat HTTP niet hun protocol is; een zelfgehoste RustDesk relay server is daar het duidelijkste voorbeeld van. Deze luistert op een aantal raw TCP- en UDP-poorten en vereist firewallregels in plaats van een subdomein. Eén proxy-instelling is cruciaal voor Immich: verhoog de limiet voor uploadgrootte, aangezien video's van telefoons groot zijn. In nginx is dit client_max_body_size 50000M; binnen het serverblok; de standaardwaarde van 1 MB wijst video-uploads af met 413 Request Entity Too Large. Als uw proxy ook Let's Encrypt HTTP-01 challenges afhandelt, zorg er dan voor dat /.well-known/immich nog steeds naar Immich wordt gerouteerd en niet naar de challenge-handler.

De regel die de app afdwingt: het eindpunt moet bereikbaar zijn op exact de URL die u invoert. De app accepteert een eenvoudige http://YOUR_SERVER_IP:2283 (de eigen login-hint is http://your-server-ip:port), maar alles wat via internet verloopt, moet HTTPS zijn. Het verkeerde schema, of een direct IP-adres zonder poortnummer, is de oorzaak van de melding "de app kan de server niet bereiken", wat hieronder als een benoemde fout wordt behandeld.

Stap 7: Externe bibliotheken versus uploads, een bestaande fotostructuur importeren

Er zijn twee manieren waarop foto's in Immich terechtkomen, en deze zijn niet hetzelfde.

• Uploads zijn assets die eigendom zijn van Immich. De app of de web-uploader kopieert het bestand naar UPLOAD_LOCATION. Immich kan deze bestanden hernoemen, verplaatsen en verwijderen.
• Externe bibliotheken zijn alleen-lezen imports van bestanden die al in een map op uw server staan, zoals een oude Pictures-structuur of een NAS-export. Immich indexeert deze op hun huidige locatie en toont ze in de tijdlijn, maar wijzigt of verwijdert de originelen nooit.

Om een bestaande structuur te importeren, koppelt u deze als alleen-lezen in de server-container. Bewerk docker-compose.yml onder immich-server: en voeg een volume toe:

  immich-server:
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
      - /srv/photos:/mnt/media/photos:ro

De :ro garandeert dat Immich de originelen nooit kan aanpassen. Maak de container opnieuw aan met sudo docker compose up -d, ga daarna in de web-UI naar uw avatar → Administration → External Libraries → Create Library, kies de eigenaar, klik op Add onder Folders en voer het containerpad in, /mnt/media/photos, niet het hostpad /srv/photos. Klik op Scan. Het gebruik van het hostpad in plaats van het containerpad is de meest gemaakte fout bij externe bibliotheken; de scan vindt dan niets en rapporteert nul assets.

Stap 8: De upgrade-discipline die Immich vereist

Dit is het onderdeel dat het verschil maakt tussen een goed werkende Immich-installatie en een defecte. Immich brengt snel nieuwe versies uit, backport geen fixes en ondersteunt geen downgrades. De zwevende v3-tag is een officieel ondersteunde manier om releases te volgen, en Immich streeft ernaar om ingrijpende wijzigingen te beperken tot grote versies. Echter, de software voert een upgrade uit zodra u een pull doet, ongeacht of u de release notes heeft gelezen, en een ongeplande upgrade kan niet ongedaan worden gemaakt. Hetzelfde principe van 'eerst pinnen, dan de notes lezen' is waardevol voor elke langdurig draaiende container op de server. Daarom wordt een zelfgehoste KiroCrew-agent vastgezet op één bekende, werkende tag in plaats van deze automatisch te laten bijwerken bij de volgende herstart. De discipline:

1. Pin een versie. Zorg dat IMMICH_VERSION is ingesteld op een concrete tag zoals v3.0.2, en niet op de zwevende v3 die altijd de nieuwste v3.x ophaalt.
2. Lees elke keer de release notes voordat u een upgrade uitvoert. Ingrijpende wijzigingen, vooral met betrekking tot de database of vector-extensies, worden daar vermeld. De v3.0-release is hier een duidelijk voorbeeld van: deze verwijderde pgvecto.rs volledig, waardoor iedereen die nog op de oude extensie zat, eerst de VectorChord-migratie (geïntroduceerd in v1.133) moest voltooien voordat er geüpgraded kon worden.
3. Maak eerst een back-up van de database (Stap 9). Doe dit altijd, maar wees extra alert wanneer de notes de database vermelden.
4. Download ook het nieuwe compose-bestand. IMMICH_VERSION pint alleen de server- en ML-images. De Postgres-image wordt vastgezet op basis van een digest binnen docker-compose.yml. Een versie die een nieuwere database-extensie vereist, wordt daarom geleverd met een nieuw compose-bestand. Download beide release-assets opnieuw, pas uw .env-waarden toe en voer daarna de upgrade uit.
5. Update eerst uw mobiele clients. De server communiceert alleen met de bijbehorende grote versie, en de app is doorgaans compatibel met de huidige en de vorige grote versie. Wanneer de server nieuwer is dan de app, tonen huidige releases (v3.3.1, gecontroleerd op 2026-10-10) een App update is available-melding met een Update-knop op de telefoon. Immich adviseert om alle mobiele clients te upgraden voordat u de server bijwerkt.

De daadwerkelijke commando's, zodra u de nieuwe bestanden op hun plek heeft:

cd /opt/immich
sudo docker compose pull
sudo docker compose up -d
sudo docker image prune

Stap 9: Back-ups, een database-dump PLUS de originelen, en test het

Een back-up van Immich bestaat uit twee onderdelen; het een zonder het ander is waardeloos. De database bevat de albumstructuur, gezichten, zoekindexen en de koppeling tussen assets en bestanden. De directory met originelen bevat de daadwerkelijke foto's. Herstelt u de een zonder de ander, dan krijgt u ofwel foto's zonder organisatie, ofwel een lege schil die naar ontbrekende bestanden verwijst. Deze tweedelige structuur is geen eigenaardigheid van Immich: een zelfgehoste Chatwoot-supportdesk vereist hetzelfde paar van een Postgres-dump en de bijbehorende uploads-directory, anders keert de herstelde inbox terug zonder bijlagen. Het kopiëren van de Postgres-datamap als een bestandssysteem lijkt een kortere weg ten opzichte van de dump-stap, maar dit is geen bruikbare back-up. Dit is een valkuil die de volledige Immich back-up en restore handleiding behandelt, naast de fout bij het herstellen waardoor u achterblijft met een lege tijdlijn.

Maak een dump van de database met pg_dump vanuit de Postgres-container, specifiek van de immich-database en niet van het hele cluster:

sudo docker exec -t immich_postgres pg_dump --clean --if-exists \
  --dbname=immich --username=postgres | gzip > /opt/immich/immich-db-$(date +%F).sql.gz

Maak vervolgens een back-up van UPLOAD_LOCATION, de volledige /opt/immich/library-boomstructuur, en in het bijzonder de submappen library/, upload/ en profile/, met restic, rsync of borg naar een andere machine of object storage. Welke taakplanner u ook gebruikt, een cron-entry of een systemd-timer, deze moet ergens een melding kunnen geven wanneer het mislukt. Een systemd OnFailure=-unit die verwijst naar uw eigen ntfy push-server stuurt een bericht naar uw telefoon op de avond dat een dump mislukt, in plaats van dat u daar pas achter komt tijdens een hersteloperatie. Voer eerst de database-back-up uit en daarna de bestanden, zodat de dump nooit verwijst naar een foto die nog niet door de bestandsback-up is gekopieerd. Externe bibliotheken back-upt u afzonderlijk bij de bron; Immich beheert deze niet.

Nu het onderdeel dat iedereen overslaat: test het herstel. Een herstel moet worden uitgevoerd op een schone stack waarvan de server nog nooit is gestart, op een Postgres-image waarvan de vector-extensie compatibel is met de dump. Dit is precies de reden waarom u nooit moet improviseren met de DB-image-tag. Wis op een testomgeving met dezelfde compose-configuratie en .env alle oude statusgegevens, start alleen de database en laad vervolgens de dump:

cd /opt/immich
sudo docker compose down -v
sudo docker compose pull
sudo docker compose create
sudo docker start immich_postgres
sleep 10
gunzip --stdout immich-db-2026-07-15.sql.gz |
  sed "s/SELECT pg_catalog.set_config('search_path', '', false);/SELECT pg_catalog.set_config('search_path', 'public, pg_catalog', true);/g" |
  sudo docker exec -i immich_postgres psql --dbname=immich --username=postgres --single-transaction --set ON_ERROR_STOP=on
sudo docker compose up -d

De sed-herschrijving van search_path is niet optioneel bij een VectorChord-database; laat u dit weg, dan wordt het herstel halverwege afgebroken. Wanneer de stack weer opkomt met uw originelen op de juiste plek, opent u de web-UI: als uw foto's en albums daar staan, werkt uw back-up. Als u dit nog nooit heeft uitgevoerd, heeft u geen back-up, maar slechts een hoop.

Foutmodi en de bijbehorende meldingen

De ML-container wordt beëindigd door OOM-killer. sudo docker compose logs immich-machine-learning stopt abrupt, docker compose ps toont dit Restarting, en de exitcode is 137. sudo dmesg | grep -i oom bevestigt dit: Out of memory: Killed process ... (python3). Zoek- en gezichtsherkenningstaken blijven vervolgens hangen. De oorzaak is onvoldoende RAM voor de modellen. Oplossingen, in volgorde: voeg swap toe (Stap 1); geef de VPS meer RAM; of, als dit echt niet mogelijk is, open Administration → Settings → Machine Learning Settings en schakel de overkoepelende machine learning-schakelaar uit. Hiermee worden alle ML-functies in één keer uitgeschakeld. Alleen Smart Search en Facial Recognition uitschakelen is onvoldoende, omdat OCR en de andere modeltypen standaard ingeschakeld blijven. U behoudt back-ups en albums, maar verliest de mogelijkheid om op inhoud te zoeken. Het verwijderen van de immich-machine-learning-service uit het compose-bestand heeft hetzelfde effect.

De Immich-server start niet na een upgrade. De Postgres-container draait mogelijk correct; het is immich_server die bij het opstarten de versie van de vector-extensie controleert en weigert te starten. Het logbestand toont een lus met een regel zoals The database currently has VectorChord 0.5.3 activated, but the Postgres instance only has 0.4.2 available. This most likely means the extension was downgraded., of, bij oudere stacks, The pgvecto.rs extension is not available in this Postgres instance.. De oorzaak is een database-image waarvan de extensieversie ouder is dan de versie waarnaar uw data is geüpgraded. Dit gebeurt bijna altijd door handmatig de image-tag te wijzigen of door een nieuwere dump terug te zetten op een oudere image. De oplossing is om de bijbehorende Postgres-image te gebruiken, het compose-bestand te nemen van de release die overeenkomt met uw database, niet te downgraden en alleen terug te zetten op een compatibele image.

De mobiele app kan de server niet bereiken. Het inlogscherm toont een verbindingsfout zoals Could not connect to server nadat u de URL heeft ingevoerd. De gebruikelijke oorzaken: u heeft http:// getypt terwijl de proxy alleen https:// serveert; u heeft direct verbinding gemaakt met de backend maar de poort weggelaten, waardoor deze example.com (poort 443) probeerde in plaats van example.com:2283; de reverse proxy stuurt /api niet door; of een proxy die Let's Encrypt HTTP-01-challenges afhandelt, routeert /.well-known/immich naar een andere locatie dan Immich. Los dit op door de volledige https://photos.example.com-URL in te voeren en eerst te controleren of deze in een browser op de telefoon laadt. Als de browser werkt en de app niet, verwijdert de proxy het pad of routeert deze /.well-known/immich verkeerd, of het certificaat is zelfondertekend. De app weigert dit met een handshake-fout, tenzij u ondersteuning voor zelfondertekende certificaten inschakelt in de instellingen van de app.

Schijf vol tijdens import. Uploads mislukken, miniaturen worden leeg en logs tonen ENOSPC: no space left on device of, vanuit Postgres, could not extend file ... No space left on device. df -h toont dat het UPLOAD_LOCATION-volume voor 100% vol is. Daarom moet u de schijfruimte bepalen voordat u een grote bibliotheek importeert. Herstel dit door een groter volume te koppelen, de stack te stoppen, UPLOAD_LOCATION ernaartoe te verplaatsen, .env bij te werken en opnieuw op te starten, of breid de bestaande schijf uit als uw provider dit toestaat. Postgres kan vastlopen als de schijf vol raakt; maak dus ruimte vrij en herstart de database-container voordat u uitgaat van corruptie.

FAQ

Hoeveel RAM en schijfruimte heeft Immich nodig?

De officiële vereisten van Immich zijn minimaal 6 GB RAM, met 8 GB als aanbevolen hoeveelheid. 4 GB met swap is de praktische ondergrens voor een kleine bibliotheek. Configureer in elk geval swap, omdat de machine-learning-container pieken in het verbruik veroorzaakt. Reken voor schijfruimte op de volledige grootte van uw bibliotheek plus ongeveer 10–20% voor gegenereerde thumbnails en previews op lokale opslag. Plaats de Postgres-datamap nooit op een netwerkshare. Als u nog beslist wat u verder wilt draaien, vergelijkt de gids voor zelfhosting in 2026 de voetafdruk van Immich met andere services.

Kan ik Immich draaien zonder GPU?

Ja. De machine-learning-container draait prima op de CPU; een GPU versnelt enkel het indexeren voor slim zoeken en, met de juiste image-variant, videotranscodering. Op een CPU kan het initiële indexeren van een grote bibliotheek uren op de achtergrond duren, maar dit blokkeert het maken van back-ups of het bladeren door foto's niet. Als uw systeem te beperkt is voor ML, kunt u machine learning volledig uitschakelen via de schakelaar in de admin-instellingen en de rest van de functionaliteit behouden.

Hoe upgrade ik Immich veilig?

Pin IMMICH_VERSION vast op een specifieke tag zoals v3.0.2, lees voor elke upgrade de release notes en maak eerst een back-up van de database. Omdat de Postgres-image binnen docker-compose.yml is vastgezet in plaats van via IMMICH_VERSION, moet u zowel het compose-bestand als example.env opnieuw downloaden van de betreffende release, uw waarden opnieuw toepassen en vervolgens docker compose pull && docker compose up -d uitvoeren. Laat de versie nooit onbeheerd zweven; Immich ondersteunt geen downgrades, dus een upgrade waar u zich niet op heeft ingelezen, kan niet ongedaan worden gemaakt.

Wat moet ik precies back-uppen?

Twee zaken, in samenhang: een pg_dump van de immich-database en de volledige UPLOAD_LOCATION-map met originelen. De database bevat albums, gezichten en de koppeling tussen assets en bestanden; de map bevat de daadwerkelijke foto's. Een herstelactie vereist beide, plus een database-image met een compatibele vector-extensie. Maak eerst de database-dump en kopieer daarna de bestanden. Test het herstel minstens één keer op een testsysteem; een niet-geteste back-up is geen back-up.

Hoe importeer ik mijn bestaande fotomap?

Mount de map 'read-only' in de immich-server-container als een extra volume (bijvoorbeeld - /srv/photos:/mnt/media/photos:ro), herstart de container en maak vervolgens in Administration → External Libraries een bibliotheek aan. Voeg daar het container-pad /mnt/media/photos toe. Immich indexeert de bestanden op hun locatie en zal deze nooit wijzigen of verwijderen. De meest gemaakte fout is het invoeren van het host-pad in plaats van het container-pad, waardoor de scan niets vindt.