Installatie

Overstappen vanaf Immich

Draait Immich al bij je? Overstappen is eenvoudig — vervang twee image-namen in je docker-compose.yml en verhoog IMMICH_VERSION in je .env. De huidige versie is v4.

image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}

Laad daarna de nieuwe images en herstart:

docker compose pull && docker compose up -d

Je gegevens, database en configuratie zijn volledig compatibel — geen migratiestappen nodig.

Benieuwd wat Gallery toevoegt aan Immich? Lees de volledige vergelijking Gallery vs. Immich →

Vereisten

Configuratiebestanden downloaden

Maak een map aan voor Noodle Gallery en download het Docker Compose-bestand en de omgevingssjabloon.

mkdir ./noodle-gallery
cd ./noodle-gallery

wget -O docker-compose.yml https://github.com/open-noodle/gallery/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/open-noodle/gallery/releases/latest/download/example.env

Omgeving configureren

Open het .env-bestand en pas je instellingen aan. De belangrijkste opties staan bovenaan — S3-opslag is optioneel.

# ── Basisinstellingen ─────────────────────────────────────────

# Opslaglocatie voor foto's en video's
UPLOAD_LOCATION=./library

# Opslaglocatie voor PostgreSQL-gegevens (moet een lokale schijf zijn, geen netwerkschijf)
DB_DATA_LOCATION=./postgres

# Tijdzone: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
TZ=Etc/UTC

# Container-image-tag — "release" voor de nieuwste, "v4" voor de laatste v4.x of bijv. "v4.0.1" vastzetten
IMMICH_VERSION=release

# BELANGRIJK: vervangen door een willekeurig wachtwoord (alleen A-Za-z0-9)
DB_PASSWORD=change-me-to-something-random

# Deze standaardwaarden hoeven zelden te worden gewijzigd
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# ── S3-compatibele opslag (optioneel) ────────────────────────
# Haal het commentaarteken weg om uploads in S3 op te slaan in plaats van op de lokale schijf.
# Werkt met AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi enz.

# IMMICH_STORAGE_BACKEND=s3
# IMMICH_S3_BUCKET=mijn-gallery-bucket
# IMMICH_S3_REGION=eu-central-1
# IMMICH_S3_ENDPOINT=https://s3.eu-central-1.amazonaws.com
# IMMICH_S3_ACCESS_KEY_ID=
# IMMICH_S3_SECRET_ACCESS_KEY=
# IMMICH_S3_SERVE_MODE=redirect
# IMMICH_S3_PRESIGNED_URL_EXPIRY=3600

Containers starten

Voer vanuit de map noodle-gallery het volgende commando uit:

docker compose up -d

Dit commando downloadt de container-images, maakt de database aan en start alle diensten. Bij de eerste start worden ~2 GB aan images gedownload, wat enkele minuten kan duren.

Webinterface openen

Open http://jouw-server-ip:2283 in je browser. Je wordt gevraagd om het eerste beheerdersaccount aan te maken.

De mobiele app (Android & iOS) maakt verbinding met dezelfde URL. Download hem in de Play Store of App Store en voer je server-URL in.

GPU-versnelling optioneel

Gebruik voor snellere ML-inferentie (gezichtsherkenning, CLIP, dier-herkenning) een GPU-versnelde ML-image:

# Wijzig in docker-compose.yml de ML-image-tag:
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}-cuda

Beschikbare tags: -cuda (NVIDIA), -rocm (AMD), -openvino (Intel).

Bijwerken

Bijwerken naar de nieuwste versie:

docker compose pull
docker compose up -d

Databasemigraties worden automatisch uitgevoerd bij het opstarten. Maak vóór grote versie-upgrades altijd eerst een back-up van je database.

API-documentatie

Gallery stelt een volledige REST-API beschikbaar, gedocumenteerd via OpenAPI. Elke draaiende instantie biedt een interactieve Swagger-interface op /doc — inclusief alle fork-specifieke endpoints voor Gedeelde spaces, gebruikersgroepen en dier-herkenning.

De API kun je ook doorzoeken op de live demo:

Veelgestelde vragen