Album annidati in Immich: cosa usare invece

La risposta breve: Immich non ha album annidati

Gli album annidati in Immich non esistono: un album non può contenere un altro album. Ho controllato le note di rilascio recenti fino a v3.3.4, pubblicata il 20 ottobre 2026, e i sottoalbum non compaiono. Se vuoi una struttura come Viaggi > 2025 > Sardegna, oggi hai quattro sostituti: i tag gerarchici, la vista Cartelle, gli album creati dalle cartelle al momento dell'importazione e una convenzione di nomi per i titoli. Nessuno di questi è un vero albero di album. Per questo conviene sapere cosa dà ognuno e cosa non dà.

Questa guida parte da un caso concreto. Hai anni di foto in cartelle sul disco, ordinate per tema e per anno. Le hai caricate su Immich, magari dopo aver seguito la guida per installare Immich su una VPS come alternativa a Google Foto. Adesso vuoi ritrovare la stessa struttura dentro l'app, e magari condividerla con la famiglia.

Cosa dicono le note di rilascio e la discussione #2073

Ho letto per intero le note di v3.0.0, v3.2.0 e v3.3.0, più quelle della serie v3.3 fino a v3.3.4. Nessuna menziona album annidati o sottoalbum. Le novità sugli album sono altre. In v3.3.0, per esempio, il client web ha un'azione per lasciare un album, gli editor possono modificare titolo e descrizione di un album, e c'è una scorciatoia per togliere elementi da un album.

La richiesta esiste da tempo. Su GitHub la discussione #2073 si intitola "[Feature]: Nested albums", sta nella categoria Feature Request ed è stata aperta da rain0r il 23 novembre 2022. Oggi è bloccata, quindi non accetta nuovi commenti. Il 1 ottobre 2023 il maintainer jrasm91 ha scritto che condividere album annidati "sounds pretty complicated". Il 14 novembre 2023 ha chiesto agli utenti di votare il post originale invece di aggiungere commenti. Il 20 marzo 2025 il maintainer alextran1502 ha indicato la vista Cartelle e ha spiegato che sono due funzioni diverse: "One is for folder structure, and the other is for album structure". Non ho trovato un impegno a sviluppare la funzione, quindi non esiste una data da aspettare.

Cos'è un album in Immich oggi

Un album è una raccolta piatta di foto e video. Contiene elementi, non altri album. Nell'interfaccia italiana i comandi sono "Crea album" e "Aggiungi all'album".

Un album non è una cartella sul disco. I file stanno dove li mette Immich, secondo le regole spiegate in dove Immich salva le foto quando gira in Docker. L'album è un'informazione separata, che descrive un gruppo di elementi. Questo punto conta più avanti, quando parliamo di backup.

Un album si condivide con altri utenti della stessa istanza. Per ogni persona scegli un ruolo: editor (lettura e scrittura) oppure visualizzatore (sola lettura). In alternativa crei un link pubblico, che può avere una scadenza e una password.

Tag gerarchici: la cosa più vicina a un albero

I tag gerarchici sono arrivati in Immich v1.113.0, pubblicata il 30 agosto 2024. Sono una funzione del tuo profilo e vanno attivati. Apri Impostazioni profilo > Funzionalità > Tag.

La gerarchia nasce dal carattere / nel nome. Il codice del server divide il nome del tag su ogni / e crea un tag per ogni livello. Quindi il tag Viaggi/2025/Sardegna crea tre tag: Viaggi, Viaggi/2025 e Viaggi/2025/Sardegna, ognuno figlio del precedente. Applica il tag più profondo a una foto e la ritrovi navigando da Viaggi in giù.

Se le tue foto hanno già parole chiave, Immich può leggerle. La documentazione dice che importa i tag dai campi XMP TagsList e IPTC Keywords. Le modifiche fatte in Immich vengono scritte in un file sidecar. Per importare i tag delle foto già caricate, rilancia i job di estrazione dei metadati.

Cosa non dà. Il codice crea ogni tag legato al tuo utente, quindi i tag sono tuoi, dentro il tuo account. La documentazione dei tag non descrive un modo per condividerli, mentre per gli album la condivisione è documentata. Se vuoi che tua sorella veda il ramo Famiglia/Bianchi, un tag da solo non basta: prova sulla tua istanza cosa vede un altro utente, prima di contarci.

La vista Cartelle: guardare, non organizzare

La vista Cartelle è una vista in più, accanto alla timeline. Si attiva in Impostazioni profilo > Funzionalità > Cartelle, e poi compare nella barra laterale. Nella traduzione italiana la descrizione dice che serve a navigare le foto e i video sul file system.

La documentazione spiega che è più utile con una libreria esterna ordinata con cura, oppure con un modello di archiviazione (storage template) personalizzato. Il motivo è semplice: la vista mostra le cartelle come sono. Se hai una libreria esterna con Viaggi/2025/Sardegna già sul disco, la vista Cartelle ti mostra proprio quell'albero.

Cosa non dà. La documentazione descrive solo la navigazione, nessuna funzione per spostare file o rinominare cartelle. Se le cartelle sul disco hanno nomi disordinati, la vista mostra lo stesso disordine. Per riordinare devi lavorare sui file, fuori da Immich.

Album dalle cartelle con il CLI ufficiale

Il CLI ufficiale è il pacchetto npm @immich/cli. Al 20 ottobre 2026 la versione più recente è 3.3.4, la stessa del server, e richiede Node.js 22 o superiore. Fissa la versione, così i comandi qui sotto restano validi anche dopo un aggiornamento. Se hai installato il vecchio CLI legacy, la documentazione chiede di rimuoverlo prima con npm uninstall -g immich.

node --version
npm i -g @immich/cli@3.3.4
immich login https://foto.example.com/api LA_TUA_CHIAVE_API

node --version deve stampare v22 o un numero più alto. Crea la chiave API nelle impostazioni del tuo profilo. La documentazione ricorda che puoi limitarne i permessi. L'indirizzo finisce in /api, come negli esempi ufficiali.

L'opzione --album crea gli album dai nomi delle cartelle. La documentazione dice che crea un album per ogni elemento caricato, in base al nome della cartella in cui si trova. Prima prova con --dry-run, che mostra cosa succederebbe senza caricare niente.

immich upload --album --recursive --dry-run ~/Foto/Viaggi
immich upload --album --recursive ~/Foto/Viaggi

Se invece vuoi mettere tutta una cartella in un solo album con un titolo scelto da te, usa --album-name:

immich upload --album-name "Viaggi · 2025 · Sardegna" --recursive ~/Foto/Viaggi/2025/Sardegna

Cosa non dà. Gli album creati sono piatti, perché Immich non ha album annidati. L'albero delle cartelle quindi non diventa un albero di album. La documentazione non spiega come vengono chiamati gli album quando le cartelle sono annidate su più livelli. Non dare per scontato il risultato: carica prima una cartella piccola e guarda l'elenco degli album.

Album dalle cartelle con immich-go

immich-go è un progetto della comunità, non di Immich. La versione più recente è v0.32.0, pubblicata il 25 giugno 2026. Le sue note di rilascio annunciano la piena compatibilità con Immich v3.0.0, e il README lo dichiara compatibile con Immich v2 e v3. Scarica il binario per il tuo sistema dalla pagina della release v0.32.0 su GitHub.

Il comando upload from-folder legge una cartella locale. Le opzioni --server e --api-key sono obbligatorie. L'opzione --folder-as-album accetta tre valori: FOLDER, PATH e NONE, che è il predefinito. Anche qui, parti da --dry-run, che simula il caricamento senza trasferire niente.

immich-go upload from-folder --help
immich-go upload from-folder --server=https://foto.example.com --api-key=LA_TUA_CHIAVE_API --folder-as-album=FOLDER --dry-run ~/Foto/Viaggi

Il primo comando mostra le opzioni della versione che hai installato. Controlla che --folder-as-album e --dry-run compaiano, prima di lanciare il secondo.

Ci sono altre due opzioni utili. --album-path-joiner imposta la stringa che unisce i nomi delle cartelle nei titoli degli album, e il valore predefinito è " / ". --folder-as-tags usa la struttura delle cartelle come tag. Puoi anche mettere tutto in un solo album con --into-album.

Cosa non dà. La documentazione di immich-go non spiega la differenza tra FOLDER e PATH, né quali titoli escono da una struttura annidata. Per questo non lo descrivo qui. Lancia prima --dry-run con un valore, poi con l'altro, e confronta il risultato. Lo stesso vale per --folder-as-tags: verifica su una prova se i tag che crea sono gerarchici. Gli album che ottieni restano comunque piatti.

Una convenzione di nomi per i titoli degli album

Se gli album sono piatti, la gerarchia può stare nel titolo. Scegli un separatore e usalo sempre. Per esempio:

• Viaggi · 2025 · Sardegna
• Viaggi · 2024 · Dolomiti
• Famiglia · Rossi · Matrimonio di Giulia
• Famiglia · Bianchi · Natale 2025

Le regole sono poche. Vai dal generale al particolare. Scrivi l'anno con quattro cifre. Non mescolare separatori diversi, perché un album chiamato Viaggi - 2025 - Sardegna accanto a Viaggi · 2025 · Puglia rompe la serie.

Cosa dà. Il titolo viaggia con l'album, anche quando lo condividi. Funziona su ogni client, perché è solo testo. Cosa non dà. Non c'è un album padre da aprire, e rinominare un ramo significa modificare a mano molti titoli. Da v3.3.0 anche gli editor di un album condiviso possono cambiarne il titolo, quindi concorda la convenzione con chi condivide gli album con te.

Le Sequenze di v3 possono aggiungere foto a un album?

Sì. Immich v3.0.0, pubblicata il 2 luglio 2026, ha introdotto i Workflows come anteprima. Nell'interfaccia italiana si chiamano "Sequenze" e stanno in Utilità > Sequenze. Una sequenza ha un evento che la avvia (trigger) e una serie di passi. I passi sono filtri, cioè condizioni, e azioni, cioè effetti. C'è un editor visuale e un editor JSON.

Le note di v3.0.0 elencano un filtro sulla geolocalizzazione e un'azione webhook. In v3.2.0 sono arrivati un trigger quando un elemento riceve un tag, un filtro sui tag e un'azione che aggiunge tag all'elemento. In v3.3.1 i passi vengono eseguiti nell'ordine configurato. Il manifest del plugin core di v3.3.4 dichiara anche l'azione assetAddToAlbums, con il titolo "Add to Album(s)": aggiunge l'elemento agli album selezionati e, se indichi un nome, usa l'album con quel nome se esiste, altrimenti ne crea uno nuovo. Lo stesso manifest include tre modelli pronti basati su questa azione: uno archivia i caricamenti con "screenshot" nel nome del file e può metterli in un album, uno crea un album per gli elementi senza fuso orario, uno aggiunge a un album le foto scattate in un luogo preciso.

Per il nostro caso l'idea è questa: un tag Viaggi/2025/Sardegna avvia la sequenza, un filtro sui tag controlla il tag, e l'azione mette la foto nell'album Viaggi · 2025 · Sardegna. Apri Utilità > Sequenze, crea una sequenza di prova e verificala su poche foto. Ricorda che è un'anteprima, quindi può cambiare tra una versione e l'altra.

Album e tag vivono nel database: mettilo nel backup

Qualunque struttura costruisci con album, tag e titoli non esiste come cartella sul disco. La documentazione di Immich dice che il database contiene i percorsi dei file e i metadati degli utenti. Dice anche che un backup del database non contiene foto o video, solo metadati, e che va usato insieme a una copia dei file in UPLOAD_LOCATION.

La conseguenza è diretta. Se copi solo le cartelle delle foto, perdi gli album e la loro condivisione. I tag modificati in Immich finiscono anche nei file sidecar, ma gli album no. Quindi il backup del database Postgres deve esserci sempre, accanto ai file. Il procedimento completo è in backup e ripristino di Immich con database e foto. Prova un ripristino almeno una volta, prima di aver bisogno di farlo davvero.

Condivisione: un album alla volta, oppure tutto con un partner

Senza album annidati non esiste un album padre che condivide tutti i figli. Ogni album ha i suoi utenti e i suoi ruoli. Condividere Famiglia · Rossi · Matrimonio di Giulia non condivide Famiglia · Rossi · Natale 2025. Per il caso della famiglia con un ramo per ogni parente, crea un album per ramo e condividilo con le persone di quel ramo.

L'alternativa è la condivisione con un partner. Nella traduzione italiana si chiama "Condivisione Compagno". Il partner vede le tue foto e i tuoi video non archiviati, con i metadati e anche la posizione GPS. La documentazione elenca alcune esclusioni: gli album già esistenti e gli elementi preferiti restano fuori, così come i dati su persone e volti. È adatta a una coppia che gestisce lo stesso archivio, non a dieci cugini che devono vedere solo il proprio ramo.

Quale sostituto scegliere

Se le tue foto sono già ordinate in cartelle sul disco, collega una libreria esterna e attiva la vista Cartelle: vedi l'albero senza rifare nulla. Se vuoi un albero dentro Immich, usa i tag gerarchici. Se devi condividere, servono album, quindi creali all'importazione con il CLI ufficiale o con immich-go, e dai loro titoli con una convenzione chiara. Se l'organizzazione per cartelle è il centro del tuo modo di lavorare, leggi anche il confronto tra PhotoPrism e Immich prima di scegliere.

FAQ

Immich supporta gli album annidati o i sottoalbum?

No. Fino a Immich v3.3.4, pubblicata il 20 ottobre 2026, un album è una raccolta piatta e non può contenere altri album. Le note di rilascio di v3.0.0, v3.2.0 e della serie v3.3 non menzionano album annidati. La richiesta è la discussione #2073 su GitHub, aperta nel 2022 e oggi bloccata, senza una data di rilascio.

Come creo un tag gerarchico in Immich?

Attiva i tag in Impostazioni profilo > Funzionalità > Tag. Poi crea un tag con il carattere / nel nome, per esempio Viaggi/2025/Sardegna. Il server divide il nome su ogni / e crea un tag per ogni livello, quindi ottieni Viaggi, Viaggi/2025 e Viaggi/2025/Sardegna. I tag gerarchici esistono da Immich v1.113.0.

Il CLI di Immich può creare album dalle cartelle?

Sì. Con @immich/cli 3.3.4, il comando immich upload --album --recursive crea album in base al nome della cartella che contiene ogni file. Gli album restano piatti. La documentazione non spiega come vengono chiamati con cartelle annidate, quindi lancia prima lo stesso comando con --dry-run e prova su una cartella piccola.

Se faccio il backup solo delle foto, perdo gli album?

Sì. Gli album sono metadati nel database Postgres, non cartelle sul disco. La documentazione di Immich dice che il database contiene i percorsi dei file e i metadati degli utenti, e che il backup del database va usato insieme alla copia dei file in UPLOAD_LOCATION. Fai il backup di entrambi.