Il legame tra Gallery e Immich

Noodle Gallery è un fork rispettoso di Immich, la piattaforma open source di gestione delle foto self-hosted creata da Alex Tran e da una comunità in crescita. Gallery si rebasa su ogni versione upstream di Immich, in modo che le correzioni, i miglioramenti di prestazioni e le nuove funzionalità del team di Immich arrivino automaticamente in Gallery.

La relazione è volutamente semplice: Immich è la base. Gallery si appoggia su di essa e aggiunge un piccolo numero di funzionalità per casi d'uso che non rientrano nell'ambito di upstream. Stesso database, stessi container, stesso percorso di ritorno. Se cambi idea, tornare indietro è una modifica di tre righe.

Questa pagina esiste perché gli utenti di Immich si pongono legittimamente la domanda: «Che cosa cambia?». La risposta merita di essere chiara — non perché riteniamo upstream inferiore.

Dove Immich raggiunge i suoi limiti — e come Gallery li colma

Ogni funzionalità esclusiva di Gallery è nata dalla stessa osservazione: qualcuno ha incontrato un limite in Immich e cercava una soluzione. Le categorie qui sotto raggruppano questi limiti per tema — ognuna accompagnata dalle funzionalità Gallery che vi rispondono.

Persone e identità

Il limite. Il riconoscimento facciale di Immich si ferma all'account. La stessa persona reale esiste come voce distinta nella tua libreria, in quella del tuo partner e in ogni album condiviso che toccate entrambi. Se la cerchi, trovi solo un terzo delle sue foto. Se la nomini in un account, nulla si propaga agli altri. La pagina Persone indica in quale contenitore qualcuno compare — non chi figura davvero nella tua vita.

Come Gallery lo risolve.

Condivisione e collaborazione

Il limite. Le due primitive di condivisione di Immich — la condivisione con un partner e gli album — raggiungono i loro limiti oltre le due persone. La condivisione partner è tutto o niente. Gli album appartengono alla persona che li ha creati. Non esiste una timeline familiare comune, né un registro delle attività, né un «cosa c'è di nuovo dalla mia ultima visita», né un modo per condividere decine di migliaia di foto senza selezionarle a mano.

Come Gallery lo risolve.

Ricerca e scoperta

Il limite. Ogni pagina di Immich ha la propria ricerca; non esiste un punto d'ingresso globale centrato sulla tastiera. I risultati della ricerca intelligente arrivano in ordine di pertinenza, senza ordinamento per data né soglia di similarità. I filtri funzionano in modo isolato.

Come Gallery lo risolve.

IA e automazione

Il limite. L'interfaccia IA di Immich si concentra sui volti e sulla ricerca CLIP di base. Gli animali non vengono riconosciuti. I ricordi mostrano solo «In questo giorno». Non esiste un modo automatico per togliere il disordine dalla timeline.

Come Gallery lo risolve.

Gestione dei media e migrazione

Il limite. Tagliare un video in Immich significa: esportare, modificare esternamente, reimportare. Passare da Google Foto richiede strumenti CLI e script. Lo storage è un disco locale o librerie esterne, ma senza un backend di storage compatibile S3 nativo.

Come Gallery lo risolve.

Mobile

Il limite. Filtrare la timeline nell'app Immich comporta passare a una scheda Ricerca separata e perdere la posizione di scorrimento. Le interfacce avanzate come la mappa, la ricerca contestuale e gli Spazi condivisi sono nascoste nell'app o assenti.

Come Gallery lo risolve.

I limiti a confronto diretto

Una vista sintetica delle stesse lacune e delle loro soluzioni — comoda se vuoi vedere l'insieme in una tabella.

docker-compose.yml
-image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
+image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}
-image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
+image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}
Guida completa alla migrazione
Dove Immich raggiunge i suoi limiti Come Gallery li risolve
I filtri mobili escono dalla scheda Foto e fanno perdere la posizione di scorrimento Pannello di filtri direttamente nella scheda Foto — persone, luoghi, tag, data, valutazione, tipo di media
La condivisione partner è tutto o niente; gli album appartengono al creatore; il riconoscimento facciale si ferma all'account Spazi condivisi con timeline multi-proprietario, ruoli, riconoscimento facciale tra account, monitoraggio dell'ultima visita e registro delle attività
La stessa persona può comparire come più voci in librerie private e condivise Persone globali — righe di persone, filtri e risultati di ricerca che tengono conto dell'identità sugli spazi con timeline accessibili
Gli animali non vengono riconosciuti Riconoscimento degli animali con YOLO11 e gruppi di animali dedicati
I ricordi mostrano solo “In questo giorno” Ricordi più intelligenti con retrospettive di viaggi e anniversari
I ricordi generati scompaiono dopo la loro finestra di carosello quotidiana Archivio dei ricordi con ricerca e conservazione configurabile
Ogni pagina ha la propria ricerca; nessun punto d'ingresso globale da tastiera Palette di ricerca tramite Cmd/Ctrl+K da qualsiasi punto
I filtri avanzati obbligano a lasciare il flusso da tastiera per accedere al pannello dei filtri Filtri di ricerca integrati — digitare filtri strutturati direttamente nella barra di ricerca, con suggerimenti in tempo reale e stato dell'URL condivisibile
Navigare in una grande libreria obbliga a scorrere ogni bucket quotidiano — impossibile saltare a un anno o a un mese con un colpo d'occhio Raggruppamento della timeline — selettore Anni / Mesi / Tutto su ogni timeline; fai zoom in avanti e indietro toccando una scheda di anno o di mese per ritrovare velocemente una foto in una libreria vecchia di decenni
La ricerca intelligente non ha ordinamento per data né soglia di pertinenza Ordinamento per data, scorrimento infinito per data, soglia di similarità regolabile
I filtri funzionano in modo isolato I filtri dipendenti si restringono a vicenda in tempo reale
La mappa non ha un proprio pannello di filtri Pannello di filtri completo sulla mappa, i marcatori si aggiornano in tempo reale
Nessuno storage compatibile S3 nativo AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi o qualsiasi storage compatibile S3
L'importazione da Google Foto richiede strumenti CLI e script Assistente di importazione guidato per gli archivi Google Takeout nel browser
Tagliare un video significa esportare e ricodificare Taglio senza perdita tramite copia del flusso, quasi istantaneo

Importante: ogni soluzione qui sopra è additiva. Gallery non sostituisce nulla di ciò che Immich fa. Le funzionalità principali, l'API REST, le app ufficiali Immich, le integrazioni di terze parti, Frame, la domotica — tutto continua a funzionare su un server Gallery.

Dovresti restare su Immich upstream?

Esistono motivi reali per far girare Immich upstream invece del fork. Non sono argomenti di facciata, ma casi in cui upstream è la scelta giusta.

Dimensione della comunità e storico

Immich è attivo dal 2022, ha decine di migliaia di stelle su GitHub, numerosi contributori e un grande Discord. Se desideri il comfort di una grande comunità, upstream è il posto giusto.

Test su una maggiore varietà di piattaforme

Immich upstream funziona su un numero molto elevato di combinazioni hardware e di NAS. Se la tua configurazione è insolita, questa maggiore superficie di test ti sarà utile.

Non hai bisogno delle aggiunte

Se non hai bisogno degli Spazi condivisi, del riconoscimento degli animali, dello storage S3, delle importazioni da Google Takeout o dei filtri avanzati, Immich upstream fa già tutto ciò che desideri.

Migrare da Immich è una modifica di tre righe

Se Immich gira già da te e vuoi provare Gallery, il passaggio è banale. Sostituisci due nomi di immagini nel tuo docker-compose.yml e imposta IMMICH_VERSION su v4 nel tuo .env.

2 file modificati +3 −3
docker-compose.yml
- image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
+ image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}
- image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
+ image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}
.env
- IMMICH_VERSION=release
+ IMMICH_VERSION=v4

Poi, scarica le nuove immagini e riavvia:

docker compose pull && docker compose up -d

Nessuna migrazione di dati. Nessuna conversione di database. Nessuna copia di file. La tua libreria resta esattamente dove si trova.

Esegui un backup del tuo database prima di iniziare — basta un solo comando: docker exec -t your-db-container pg_dumpall -U postgres > backup.sql

La guida completa passo passo si trova nella pagina di installazione. Vedi la guida alla migrazione →

Hai cambiato idea? Torna indietro con uno script.

Gallery include uno script SQL di pulizia che rimuove tutte le estensioni del database specifiche di Gallery. Le tue foto e i tuoi video non vengono mai toccati. Basta riportare i due nomi di immagini e sei di nuovo su upstream.

Leggi la guida per tornare indietro
La missione di Gallery è rendere disponibile un piccolo numero di funzionalità aggiuntive senza costringerti a scegliere tra esse e la roadmap di Immich.

Domande frequenti

I miei dati sono al sicuro se passo da Immich a Noodle Gallery?

Sì. Gallery usa lo stesso schema di database, la stessa struttura della cartella di upload e gli stessi formati di file di Immich upstream. La migrazione consiste nel modificare due nomi di immagini nel tuo docker-compose.yml. La tua libreria non viene mai copiata, trasformata né riscritta — Gallery legge e scrive esattamente gli stessi file che Immich usa già.

Posso tornare a Immich upstream in seguito?

Sì. Gallery include uno script di pulizia che rimuove dal database ogni tabella, colonna e marcatore di migrazione specifici di Gallery. Le tue foto e i tuoi video non vengono mai toccati. Esegui lo script, riporta i due nomi di immagini a ghcr.io/immich-app/immich-server e ghcr.io/immich-app/immich-machine-learning, lancia docker compose pull e sei di nuovo su upstream.

Gallery divergerà da Immich con il tempo?

No, l'obiettivo è l'esatto contrario. Gallery si rebasa su ogni versione upstream di Immich, in modo che le correzioni, i miglioramenti di prestazioni e le nuove funzionalità del team di Immich arrivino automaticamente in Gallery. Le funzionalità esclusive di Gallery sono additive — si appoggiano su upstream, non lo sostituiscono.

Quanto velocemente Gallery si rebasa dopo una nuova versione di Immich?

Di solito nel giro di pochi giorni. Il processo di rebase è automatizzato dove ha senso e manuale dove è necessario. L'obiettivo è restare abbastanza vicini perché Gallery assomigli a un Immich leggermente arricchito, e non a un progetto diverso.

Gallery ha un'app mobile?

Sì. Noodle Gallery è disponibile sull'App Store per iPhone e su Google Play per Android, con backup automatico in background dalla fotocamera, ricerca CLIP sul dispositivo, vista mappa e Spazi condivisi. Anche le app Immich upstream funzionano con i server Gallery tramite l'API comune.

Le app di terze parti per Immich continuano a funzionare con Noodle Gallery?

Sì, completamente. Gallery espone la stessa API REST di Immich upstream — stessi endpoint, stessi percorsi, stessi payload. Tutto ciò che funziona con Immich funziona senza modifiche con Gallery: client mobili, app ufficiali Immich, Immich Frame, integrazioni domotiche, strumenti CLI e script.

Perché creare un fork invece di contribuire le funzionalità a upstream?

Diverse funzionalità esclusive di Gallery — come gli Spazi condivisi, il riconoscimento degli animali e i filtri contestuali — sono state rifiutate in upstream, considerate fuori ambito, oppure avrebbero richiesto modifiche architetturali incompatibili con la roadmap di Immich. Il fork consente di sperimentare senza frenare il team upstream — e il rebase garantisce che non perdiamo i loro progressi.

Una nota per il team Immich upstream

Noodle Gallery esiste perché esiste Immich. Dobbiamo al team upstream l'architettura, la progettazione del database, le app mobili, l'integrazione CLIP e l'impressionante cadenza di rilascio. Se trovi Gallery utile, valuta di dare una stella, una sponsorizzazione o un contributo a immich-app/immich.