Installazione

Migrare da Immich

Usi già Immich ? La migrazione è semplice — sostituisci due nomi di immagine nel tuo docker-compose.yml e aggiorna IMMICH_VERSION nel tuo .env. La versione attuale è v4.

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

Scarica poi le nuove immagini e riavvia :

docker compose pull && docker compose up -d

I tuoi dati, il database e la configurazione sono completamente compatibili — non è necessario alcun passaggio di migrazione.

Curioso di scoprire cosa Gallery aggiunge a Immich ? Leggi il confronto completo Gallery vs. Immich →

Requisiti

Scaricare i file di configurazione

Crea una cartella per Noodle Gallery e scarica il file Docker Compose insieme al modello di ambiente.

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

Configurare l\'ambiente

Apri il file .env e regola le tue impostazioni. Le opzioni principali si trovano in alto — lo storage S3 è facoltativo.

# ── Impostazioni di base ─────────────────────────────────────────

# Posizione di archiviazione di foto e video
UPLOAD_LOCATION=./library

# Posizione dei dati PostgreSQL (deve essere un disco locale, non un\'unità di rete)
DB_DATA_LOCATION=./postgres

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

# Tag dell\'immagine del container — "release" per la versione attuale, "v4" per l\'ultima v4.x o fissare ad es. "v4.0.1"
IMMICH_VERSION=release

# IMPORTANTE : Sostituire con una password casuale (solo A-Za-z0-9)
DB_PASSWORD=change-me-to-something-random

# Questi valori predefiniti raramente hanno bisogno di essere modificati
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# ── Storage compatibile con S3 (facoltativo) ────────────────────────
# Rimuovi il commento per archiviare gli upload su S3 anziché sul disco locale.
# Funziona con AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi, ecc.

# IMMICH_STORAGE_BACKEND=s3
# IMMICH_S3_BUCKET=il-mio-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

Avviare i container

Esegui il seguente comando dalla cartella noodle-gallery :

docker compose up -d

Questo comando scarica le immagini dei container, crea il database e avvia tutti i servizi. Al primo avvio vengono scaricati circa 2 GB di immagini, il che può richiedere alcuni minuti.

Accedere all\'interfaccia web

Apri http://ip-del-tuo-server:2283 nel tuo browser. Ti verrà chiesto di creare il primo account amministratore.

L\'app mobile (Android & iOS) si connette allo stesso URL. Scaricala dal Play Store o dall\'App Store e inserisci l\'URL del tuo server.

Accelerazione GPU facoltativo

Per un\'inferenza ML più veloce (riconoscimento facciale, CLIP, riconoscimento di animali), usa un\'immagine ML accelerata via GPU :

# In docker-compose.yml, modifica il tag dell\'immagine ML :
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}-cuda

Tag disponibili : -cuda (NVIDIA), -rocm (AMD), -openvino (Intel).

Aggiornare

Aggiornare all\'ultima versione :

docker compose pull
docker compose up -d

Le migrazioni del database vengono eseguite automaticamente all\'avvio. Esegui sempre un backup del database prima degli aggiornamenti importanti.

Documentazione dell\'API

Gallery espone un\'API REST completa documentata tramite OpenAPI. Ogni istanza in esecuzione offre un\'interfaccia Swagger interattiva su /doc — inclusi tutti gli endpoint specifici del fork per gli Spazi condivisi, i gruppi di utenti e il riconoscimento di animali.

L\'API è consultabile anche sulla demo dal vivo :

Domande frequenti