Il 19 ottobre 2026 abbiamo cancellato tutto da un server Immich di test, compreso il repository Borg locale. Restavano solo il repository Borg esterno e la sua chiave esportata. Partendo da questi due elementi, un'installazione da zero ha riportato indietro l'intera libreria.
Su un VPS di DreamHost, eseguire questi backup tocca a te. Il supporto di DreamHost è disponibile 24/7 per hardware, rete e connettività, mentre sistema operativo, software e configurazione li gestisci tu. Il Centro assistenza di DreamHost spiega che, poiché hai il pieno controllo del VPS, DreamHost non può accedere ai tuoi dati, né eseguirne il backup o recuperarli. Immich crea un proprio dump del database ogni notte alle 2:00. Ma quei dump contengono solo metadati, mai foto o video. Su un server Immich di DreamHost, l'helper immich-backup esegue il dump del database e avvisa che devi copiare separatamente la cartella della libreria fuori dal server. Se stai ancora traslocando da Google Photos, conserva i file di Takeout finché non avrai eseguito il primo backup descritto qui sotto. Se non hai ancora scelto un'app per le foto, parti da come Immich si confronta con PhotoPrism, Ente e Nextcloud.
Cosa deve contenere il backup
La documentazione di Immich spiega che Immich salva i percorsi dei file e i metadati degli utenti nel database e non analizza la cartella della libreria, quindi un backup deve contenere entrambi, presi la stessa notte. Album, condivisioni e modifiche si trovano in quei metadati. Se ripristini le foto senza il database, ottieni file sparsi senza album. Se ripristini il database senza le foto, Immich punta a file che non esistono. Le dimensioni qui sotto vengono dal secondo backup della nostra libreria di test.
| Componente | Va salvato? (dimensioni nel nostro test) |
|---|---|
| Dump del database: album, persone, condivisioni, modifiche e posizione di ogni file | Sì, per primo (56,7 MB in SQL semplice) |
| upload/ e library/: le tue foto e i tuoi video originali, più gli eventuali file sidecar XMP | Sì (1.075 MB) |
| profile/: immagini del profilo | Sì (nessuna impostata) |
| thumbs/: miniature e anteprime | Facoltativo, ricostruibile (214 MB) |
| encoded-video/: copie transcodificate | Facoltativo, ricostruibile (vuota, perché nessun video ne aveva bisogno) |
| backups/: i dump automatici di Immich | Inclusa con la cartella (40 MB per due) |
Escludere le due cartelle ricostruibili ci ha fatto risparmiare 214 MB su una cartella di 1,39 GB, al prezzo di dover rigenerare le miniature dopo il ripristino. I tuoi file .env e docker-compose.yml si trovano fuori dalla cartella di upload, quindi copiali una volta fuori dal server. Noi abbiamo ripristinato senza i nostri, partendo da copie nuove e con una nuova password del database, ma i tuoi ti eviteranno di dover ricercare i percorsi e la versione.
Come abbiamo ripristinato un server azzerato
Il server di test (non un server DreamHost) ospitava due account, un amministratore e un familiare. In tutto contenevano 401 foto e 4 video per 1,06 GB, più altre 5 foto nel cestino. Lo abbiamo riempito con le cose che a una famiglia mancherebbero se sparissero. Alcune foto erano tra i preferiti, con descrizioni e valutazioni a stelle, alcune erano archiviate e altre avevano date e luoghi modificati. Un album era condiviso con il secondo account. Un link di condivisione aveva una password e una data di scadenza.
Ogni backup ha seguito lo script Borg di Immich con Borg 1.4.0. Lo script eseguiva il dump del database nella cartella di upload, poi copiava quella cartella in un repository cifrato fuori dalla VM, escludendo miniature e video transcodificati. Dopo la cancellazione, abbiamo ricostruito il server in quest'ordine.
- Reinstalla Immich dai suoi file ufficiali
Scarica copie nuove di
docker-compose.ymleexample.envdalla guida rapida di Immich. In.env, impostaIMMICH_VERSIONsulla versione che usavi, perché il valore predefinitov3scarica la release v3 più recente. La trovi nel nome di ogni dump automatico. Abbiamo anche impostato una password del database diversa da quella del vecchio server, edocker compose pullha richiesto 16,4 secondi con la nostra connessione. - Estrai l'archivio più recente dal repository esterno
Esegui
borg extractper l'archivio più recente e sposta le cartelle nella nuova posizione di upload. Il nostro, da 1,15 GB, è stato estratto in 4,8 secondi. Se hai esclusothumbs/eencoded-video/dal backup, la pagina sull'integrità di Immich indica di creare un file.immichvuoto in ciascuna di quelle cartelle, perché Immich lo cerca all'avvio. - Ripristina il database prima che Immich si avvii
Il ripristino da riga di comando di Immich richiede un'installazione nuova in cui il server Immich non sia mai stato avviato dalla creazione dei container, quindi avvia solo Postgres. Questi sono i comandi di Immich, con il nome del database e l'utente predefiniti di
example.env. Sostituiscigunzip --stdoutconcatquando il dump è in SQL semplice, come lo crea lo script di Immich.bashdocker compose create docker start immich_postgres sleep 10 gunzip --stdout "/path/to/backup/dump.sql.gz" \ | sed "s/SELECT pg_catalog.set_config('search_path', '', false);/SELECT pg_catalog.set_config('search_path', 'public, pg_catalog', true);/g" \ | docker exec -i immich_postgres psql --dbname=immich --username=postgres --single-transaction --set ON_ERROR_STOP=onQuesto passaggio, inclusa l'attesa di 10 secondi, ha richiesto 19,9 secondi.
- Avvia Immich
Esegui
docker compose up -d. Il nostro ha risposto in 3,9 secondi e la vecchia password dell'amministratore ha funzionato. Contando mezzo secondo per creare la cartella e spostare i file, i passaggi del ripristino hanno richiesto in totale 46 secondi. - Rigenera le miniature con l'opzione All
La timeline non mostrava miniature, perché non erano nel backup. La pagina sull'integrità di Immich suggerisce di eseguire il job delle miniature per gli elementi mancanti, e ci aspettavamo che funzionasse. Ma sul nostro server ripristinato quell'opzione non ha messo in coda nulla, perché il database elencava ancora tutti i percorsi delle miniature. In Amministrazione, apri le code dei job ed esegui invece il job delle miniature con All. Ha rigenerato 810 miniature e anteprime in 100 secondi, circa 8 file al secondo sulla nostra VM con 2 vCPU. Le vere foto scattate col telefono sono più grandi, quindi aspettati una velocità inferiore con una libreria di famiglia.

Su un server reale, l'estrazione procede alla velocità del collegamento con il tuo repository esterno, quindi una libreria grande richiede molto più tempo della nostra. Abbiamo confrontato il server ripristinato con uno snapshot creato prima della cancellazione.
| Verifica | Dopo il ripristino |
|---|---|
| Account e password dell'amministratore | Entrambi gli account recuperati, e la vecchia password ha funzionato |
| File nella cartella di upload | Tutti i 470 identici byte per byte secondo SHA-256: 406 foto (5 nel cestino), 4 video e 60 file sidecar |
| Numero di foto e video, dimensione totale | Invariati |
| Preferiti, valutazioni, descrizioni, archivio, cestino, date e luoghi modificati, album, ruoli di condivisione e link di condivisione | Invariati |
| Controlli di integrità di Immich | 0 checksum non corrispondenti e 0 file non tracciati. I 10 file mancanti erano le miniature e le anteprime delle 5 foto nel cestino, che la rigenerazione salta |
Il ripristino web di Immich
In Immich v3 puoi anche ripristinare dalla schermata di benvenuto di un server nuovo, e Immich consiglia la procedura web alla maggior parte delle persone. L'abbiamo provata su una seconda installazione cancellata, dopo aver ricopiato l'intera cartella di upload, miniature e backups/ inclusi, 1,39 GB in tutto.
La schermata di benvenuto offre Getting Started o Restore From Backup. Fai clic sulla seconda opzione e Immich si riavvia in modalità manutenzione. Il nostro browser di test headless è rimasto fermo su Server is restarting
per 2 minuti, quindi abbiamo effettuato l'accesso tramite il link di login di manutenzione che il server scrive nel suo log, visibile con docker logs immich_server. Un browser normale potrebbe benissimo aggiornarsi da solo, ma non l'abbiamo verificato. Immich ha poi controllato che ogni cartella fosse leggibile e scrivibile e ha elencato i dump trovati in backups/ con data, versione e dimensione.

Abbiamo scelto il più recente, un dump creato in autonomia dal server ripristinato alle 2:00 di notte. Immich ha prima salvato un punto di ripristino di 9,5 MB del database attuale. La pagina di login è tornata disponibile 20 secondi dopo la conferma, e tutti i controlli della tabella qui sopra sono stati di nuovo superati. Questa volta le miniature sono comparse senza doverle rigenerare, perché la copia della cartella le conteneva.
Dove finiscono le tre copie
Il README di Immich ti dice di seguire sempre un piano di backup 3-2-1 per foto e video.
Su un server a noleggio, il server stesso è la prima copia (si trova già lontano da casa tua). La seconda copia va su un disco o un NAS a casa. La terza va in un repository Borg esterno. Un repository sul disco del server stesso non conta, perché consuma lo spazio del tuo piano e sparisce insieme al server. Un secondo VPS di DreamHost è fuori dal server, ma il Centro assistenza di DreamHost spiega che ogni VPS è ospitato nel data center US East di Ashburn, in Virginia, quindi non conta come copia esterna.
BorgBase, che la pagina dello script di Immich indica per i backup esterni, ospita repository Borg. Quando abbiamo consultato i suoi piani il 19 ottobre, offriva 10 GB gratis, costava 30 $ all'anno per 250 GB o 110 $ all'anno per 1 TB, e non applicava costi di trasferimento. Le foto si comprimono pochissimo, quindi ti servirà un repository grande più o meno quanto i tuoi originali. Il nostro secondo archivio è passato da 1.150 MB a 1.130 MB.
Borg salva solo ciò che è cambiato. La prima esecuzione ha aggiunto 852 MB al repository esterno. Dopo che abbiamo aggiunto 110 foto, la seconda ha aggiunto 304,7 MB (le nuove foto più il dump del database modificato). L'intero script è stato eseguito in 8,8 secondi. Un semplice job di copia invierebbe di nuovo tutto. Nemmeno una sincronizzazione è un backup, perché una foto eliminata sul server sparisce anche dalla copia sincronizzata, mentre Borg conserva gli archivi precedenti.
La prima copia fuori dal server è quella lenta. Prendi una libreria da 165 GB, più o meno il massimo che la nostra guida su Google Foto prevede per Stack 16. Sono 1.320 gigabit (165 x 8), quindi circa 44 minuti a una velocità di esempio di 500 Mbps. La copia a casa scende alla velocità di download della tua connessione domestica. Se un giorno ripristini da quella copia di casa, i dati risalgono alla velocità di upload di casa tua: con un upload da 20 Mbps ci vogliono circa 18 ore. La larghezza di banda su Immich VPS Hosting è illimitata, senza costi per eccedenze (si applica una politica di uso ragionevole).
Configura il backup notturno
Ti servono un accesso SSH al server e un repository vuoto presso il tuo servizio esterno.
- Installa Borg
Su Debian 13,
sudo apt install borgbackupinstalla Borg 1.4.0, la versione che abbiamo testato, secondo l'elenco dei pacchetti di Debian. La guida rapida di Borg approfondisce i comandi qui sotto. - Consenti al server di accedere al repository senza richiesta di password
Cron non può digitare una password, quindi aggiungi la chiave pubblica SSH del server presso il tuo servizio esterno e salva la passphrase del repository in un file leggibile solo da root.
bashsudo sh -c 'umask 077; printf "%s" "YOUR-PASSPHRASE" > /root/.borg-passphrase' - Crea il repository con la crittografia
Lo script di Immich crea i repository con
--encryption=none. Noi abbiamo attivato la cifratura per la copia esterna. Borg ti chiede la passphrase.bashborg init --encryption=repokey-blake2 ssh://USER@HOST/./immich-borg - Esporta la chiave e conservala fuori dal server
Conserva la chiave e la passphrase sul tuo computer o nel tuo password manager, perché senza di esse non puoi aprire il repository. Nella nostra prova, la chiave esportata e il repository sono state le uniche cose sopravvissute al server.
bashborg key export ssh://USER@HOST/./immich-borg immich-borg-key.txt - Salva lo script di backup
Questo è lo script di Immich con la cifratura, un solo repository, sette archivi giornalieri conservati e il flag
-trimosso dal comando di dump. Con-t, il nostro dump ha raccolto 242.266 ritorni a capo. Il dump è stato comunque ripristinato senza errori, ma un job avviato da cron non ha un terminale con cui comunicare, quindi abbiamo eliminato il flag. Lo script di Immich conserva solo archivi settimanali e mensili, quindi una foto aggiunta ed eliminata nella stessa settimana può sparire da tutti gli archivi: per questo abbiamo aggiunto--keep-daily=7. Prima della prima esecuzione, crea una volta la cartelladatabase-backupdentro la cartella di upload.bash#!/bin/sh set -eu UPLOAD_LOCATION="/path/to/immich/upload" # UPLOAD_LOCATION from Immich's .env REPO="ssh://USER@HOST/./immich-borg" export BORG_PASSCOMMAND="cat /root/.borg-passphrase" # Database first docker exec immich_postgres pg_dump --clean --if-exists --dbname=immich --username=postgres \ > "$UPLOAD_LOCATION/database-backup/immich-database.sql" # Then the files, without the rebuildable folders borg create "$REPO::{now}" "$UPLOAD_LOCATION" \ --exclude "$UPLOAD_LOCATION/thumbs/" --exclude "$UPLOAD_LOCATION/encoded-video/" # Keep 7 daily, 4 weekly and 3 monthly archives borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=3 "$REPO" borg compact "$REPO"Su un server Immich di DreamHost, esegui
immich-backupal posto della rigadocker exece aggiungi alla rigaborg createil dump che produce. Nella nostra prova non abbiamo eseguito l'helper, quindi controlla nel suo output dove si trovano il dump e la cartella della libreria, e fai puntareUPLOAD_LOCATIONlì. - Aggiungi la copia a casa
Ripeti le righe
create,pruneecompactper un secondo repository su un computer di casa, come fa lo script di Immich con le sue copie locale e remota. Il server deve raggiungere quel computer via SSH, tramite un port forwarding sul router di casa o un tunnel di rete privata tra i due. Secondo noi il tunnel è la soluzione più semplice, perché non richiede un indirizzo fisso a casa. - Eseguilo una volta, poi pianificalo con cron
Esegui lo script a mano e leggi l'output. Poi esegui
sudo crontab -ee aggiungi una riga che lo avvii ogni notte, qui alle 4:00, dopo il dump notturno di Immich.bash0 4 * * * /usr/local/bin/immich-borg.sh >> /var/log/immich-borg.log 2>&1 - Fatti avvisare quando un backup notturno fallisce
Aggiungi allo script un'ultima riga che richiama un URL di check-in, così vieni avvisato quando il backup di una notte non è andato a termine. La pagina di DreamHost su Uptime Kuma spiega che i suoi monitor push permettono ai tuoi Cron Job di fare check-in. Dopo le prime due notti,
borg listdovrebbe mostrare un nuovo archivio per ogni notte: il primo grande più o meno quanto la tua libreria, i successivi molto più piccoli.
Recupera una foto da un archivio più vecchio
Se non hai attivato il modello di archiviazione di Immich (disattivato per impostazione predefinita), le tue foto in upload/ hanno nomi casuali generati da Immich. Per trovarne una, estrai dallo stesso archivio il dump SQL in testo semplice e cerca al suo interno il nome file originale della foto. Il percorso salvato si trova sulla stessa riga. Poi estrai solo quel file.
borg extract "$REPO::ARCHIVE-NAME" path/inside/the/archive/photo.jpgEstrarre un originale dall'archivio della prima notte ha richiesto 0,5 secondi. Il suo SHA-256 corrispondeva a quello del file prima del backup. Caricalo di nuovo tramite l'app o la pagina web di Immich. Non abbiamo verificato cosa conserva una foto ricaricata, quindi metti in conto di doverla riaggiungere tu ai suoi album.
Fai un backup prima di ogni aggiornamento di Immich
Immich non supporta il downgrade, nemmeno all'interno della stessa versione minor, quindi il backup che fai prima di un aggiornamento è l'unico modo per tornare indietro. La pagina di DreamHost su Immich indica di eseguire immich-backup per il database prima di aggiornare. Annota anche la versione che stai usando. Immich la inserisce nel nome di ogni dump automatico, subito prima della versione di Postgres, e un ripristino su una versione diversa tenta automaticamente le migrazioni del database.
Ogni qualche mese, fai un ripristino di prova. borg check ha superato il controllo sul nostro repository in 1,8 secondi, ma solo un ripristino reale dimostra che Immich riparte da lì. Il test che conta è il ripristino descritto sopra su un server di prova, seguito dai controlli di integrità di Immich, che la v3 esegue ogni notte alle 3. Vedrai miniature mancanti per gli elementi nel cestino: è normale. Poi apri un album condiviso e un paio di foto modificate e controlla che siano come le avevi lasciate.
Come abbiamo misurato
DreamHost ha eseguito la prova il 19 e 20 ottobre 2026, con Immich v3.3.3. La VM di test usava Ubuntu 24.04.4 su arm64 con 2 vCPU e 7.922 MB di memoria, sotto Colima su un Mac con Apple silicon. Non è un server DreamHost e ha la metà dei core di Stack 16. Immich girava con il suo file compose e example.env, modificati solo per percorsi, fuso orario, versione fissata e password del database. Borg 1.4.0 girava in un container Debian 13. La libreria era composta da JPEG sintetici con date e coordinate GPS nei dati EXIF, più quattro brevi clip video a 1080p, in account usa e getta. Ogni passaggio è stato eseguito una sola volta.
La prova non copre l'immagine Immich di DreamHost né il suo helper immich-backup, un trasferimento su una rete reale (il repository off-site era una cartella sullo stesso Mac), una libreria da centinaia di gigabyte o un backup di una versione precedente di Immich ripristinato su una più recente. Immich v3.3.4 è uscita il 20 ottobre. Le sue note di rilascio parlano di query sulle persone più veloci e di una traduzione mancante, niente su backup o ripristino. Non abbiamo ripetuto la prova su questa versione.
Domande frequenti sul backup di Immich
Dove vengono salvati i backup di Immich?
Immich scrive i dump automatici del database nella cartella backups all'interno della sua cartella di upload, sullo stesso disco delle foto, e conserva gli ultimi 14. Tutto il resto si trova dove lo invia il tuo strumento di backup, per esempio un repository Borg a casa o presso un servizio off-site.
Posso fare il backup mentre Immich è in esecuzione?
Sì. Quando il server resta in funzione, Immich chiede di salvare prima il database e poi i file. Il suo script Borg segue quest'ordine scrivendo il dump nella cartella che copia subito dopo, così ogni archivio contiene un dump coerente con le sue foto.
Devo disattivare i dump automatici di Immich quando uso Borg?
La pagina dello script di Immich dice che puoi farlo, per risparmiare spazio, dato che ogni archivio Borg contiene già il proprio dump. Noi li lasceremmo attivi. Nel nostro test due dump occupavano 40 MB, e sono proprio l'elenco da cui scegli nel ripristino web di Immich.
Fonti
- Immich VPS Hosting, DreamHost, 22 ott 2026. dreamhost.com/hosting/vps/immich
- VPS Hosting, DreamHost, 22 ott 2026. dreamhost.com/hosting/vps
- Cancel a VPS, DreamHost Help Center, 22 ott 2026. help.dreamhost.com/hc/en-us/articles/50609419977748-Cancel-a-VPS
- VPS overview, DreamHost Help Center, 22 ott 2026. help.dreamhost.com/hc/en-us/articles/50476238203028-VPS-overview
- Backup and Restore, Immich, 16 ott 2026. docs.immich.app/administration/backup-and-restore
- Backup Script, Immich, 16 ott 2026. docs.immich.app/guides/template-backup-script
- System Integrity, Immich, 16 ott 2026. docs.immich.app/administration/system-integrity
- Upgrading, Immich, 16 ott 2026. docs.immich.app/install/upgrading
- Post installation steps, Immich, 16 ott 2026. docs.immich.app/install/post-install
- FAQ, Immich, 16 ott 2026. docs.immich.app/FAQ
- Quick start, Immich, 16 ott 2026. docs.immich.app/overview/quick-start
- Requirements, Immich, 16 ott 2026. docs.immich.app/install/requirements
- Immich README, immich-app/immich on GitHub, 16 ott 2026. github.com/immich-app/immich
- Release v3.3.4, immich-app/immich on GitHub, 20 ott 2026. github.com/immich-app/immich/releases/tag/v3.3.4
- Quick Start, BorgBackup, 16 ott 2026. borgbackup.readthedocs.io/en/stable/quickstart.html
- borgbackup package versions, Debian, 16 ott 2026. qa.debian.org/madison.php?package=borgbackup&table=debian
- BorgBase plans, BorgBase, 19 ott 2026. borgbase.com