Installation

Migrer depuis Immich

Vous utilisez déjà Immich ? La migration est simple — remplacez deux noms d\'image dans votre docker-compose.yml et mettez à jour IMMICH_VERSION dans votre .env. La version actuelle est v4.

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

Téléchargez ensuite les nouvelles images et redémarrez :

docker compose pull && docker compose up -d

Vos données, base de données et configuration sont entièrement compatibles — aucune étape de migration n\'est nécessaire.

Curieux de ce que Gallery apporte à Immich ? Lire la comparaison complète Gallery vs. Immich →

Prérequis

Télécharger les fichiers de configuration

Créez un répertoire pour Noodle Gallery et téléchargez le fichier Docker Compose ainsi que le modèle d\'environnement.

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

Configurer l\'environnement

Ouvrez le fichier .env et ajustez vos paramètres. Les options principales se trouvent en haut — le stockage S3 est facultatif.

# ── Paramètres de base ─────────────────────────────────────────

# Emplacement de stockage des photos et vidéos
UPLOAD_LOCATION=./library

# Emplacement des données PostgreSQL (doit être un disque local, pas un lecteur réseau)
DB_DATA_LOCATION=./postgres

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

# Tag de l\'image conteneur — "release" pour la version actuelle, "v4" pour la dernière v4.x ou épingler ex. "v4.0.1"
IMMICH_VERSION=release

# IMPORTANT : À remplacer par un mot de passe aléatoire (uniquement A-Za-z0-9)
DB_PASSWORD=change-me-to-something-random

# Ces valeurs par défaut n\'ont rarement besoin d\'être modifiées
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# ── Stockage compatible S3 (facultatif) ────────────────────────
# Décommentez pour stocker les uploads dans S3 plutôt que sur le disque local.
# Fonctionne avec AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi, etc.

# IMMICH_STORAGE_BACKEND=s3
# IMMICH_S3_BUCKET=mon-bucket-gallery
# 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

Démarrer les conteneurs

Exécutez la commande suivante depuis le répertoire noodle-gallery :

docker compose up -d

Cette commande télécharge les images des conteneurs, crée la base de données et démarre tous les services. Au premier démarrage, environ 2 Go d\'images sont téléchargés, ce qui peut prendre quelques minutes.

Accéder à l\'interface web

Ouvrez http://ip-de-votre-serveur:2283 dans votre navigateur. Il vous sera demandé de créer le premier compte administrateur.

L\'application mobile (Android & iOS) se connecte à la même URL. Téléchargez-la sur le Play Store ou l\'App Store et saisissez l\'URL de votre serveur.

Accélération GPU facultatif

Pour une inférence ML plus rapide (reconnaissance faciale, CLIP, détection d\'animaux), utilisez une image ML accélérée par GPU :

# Dans docker-compose.yml, modifiez le tag de l\'image ML :
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}-cuda

Tags disponibles : -cuda (NVIDIA), -rocm (AMD), -openvino (Intel).

Mettre à jour

Mettre à jour vers la dernière version :

docker compose pull
docker compose up -d

Les migrations de base de données sont exécutées automatiquement au démarrage. Sauvegardez toujours votre base de données avant les mises à niveau majeures.

Documentation de l\'API

Gallery expose une API REST complète documentée via OpenAPI. Chaque instance en cours d\'exécution propose une interface Swagger interactive sous /doc — incluant tous les points de terminaison spécifiques au fork pour les Espaces partagés, les groupes d\'utilisateurs et la détection d\'animaux.

L\'API est également consultable sur la démo en direct :

Questions fréquentes