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.

ComponenteVa salvato? (dimensioni nel nostro test)
Dump del database: album, persone, condivisioni, modifiche e posizione di ogni fileSì, per primo (56,7 MB in SQL semplice)
upload/ e library/: le tue foto e i tuoi video originali, più gli eventuali file sidecar XMPSì (1.075 MB)
profile/: immagini del profiloSì (nessuna impostata)
thumbs/: miniature e anteprimeFacoltativo, ricostruibile (214 MB)
encoded-video/: copie transcodificateFacoltativo, ricostruibile (vuota, perché nessun video ne aveva bisogno)
backups/: i dump automatici di ImmichInclusa 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.

  1. Reinstalla Immich dai suoi file ufficiali

    Scarica copie nuove di docker-compose.yml e example.env dalla guida rapida di Immich. In .env, imposta IMMICH_VERSION sulla versione che usavi, perché il valore predefinito v3 scarica 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, e docker compose pull ha richiesto 16,4 secondi con la nostra connessione.

  2. Estrai l'archivio più recente dal repository esterno

    Esegui borg extract per 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 escluso thumbs/ e encoded-video/ dal backup, la pagina sull'integrità di Immich indica di creare un file .immich vuoto in ciascuna di quelle cartelle, perché Immich lo cerca all'avvio.

  3. 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. Sostituisci gunzip --stdout con cat quando il dump è in SQL semplice, come lo crea lo script di Immich.

    bash
    docker 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=on

    Questo passaggio, inclusa l'attesa di 10 secondi, ha richiesto 19,9 secondi.

  4. 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.

  5. 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.

Grafico a barre dei secondi per ogni passaggio del ripristino sulla nostra VM di test arm64: download delle immagini di Immich 16,4 secondi, estrazione dell'archivio Borg da 1,15 GB 4,8, ripristino del database 19,9, avvio di Immich 3,9 e rigenerazione delle miniature con l'opzione All 100.
Un ripristino, misurato su una VM di test arm64 con 2 vCPU e 8 GB. Fonte: la nostra VM di test, non un server DreamHost, 19 e 20 ottobre 2026.

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.

VerificaDopo il ripristino
Account e password dell'amministratoreEntrambi gli account recuperati, e la vecchia password ha funzionato
File nella cartella di uploadTutti 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 totaleInvariati
Preferiti, valutazioni, descrizioni, archivio, cestino, date e luoghi modificati, album, ruoli di condivisione e link di condivisioneInvariati
Controlli di integrità di Immich0 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.

Schermata Restore From Backup di Immich che elenca due dump notturni del database per data, ciascuno con la versione di Immich, la dimensione e un pulsante Restore.
La schermata Restore From Backup di Immich sulla nostra VM di test (non un server DreamHost), con l'elenco dei dump nella cartella backups.

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.

  1. Installa Borg

    Su Debian 13, sudo apt install borgbackup installa 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.

  2. 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.

    bash
    sudo sh -c 'umask 077; printf "%s" "YOUR-PASSPHRASE" > /root/.borg-passphrase'
  3. 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.

    bash
    borg init --encryption=repokey-blake2 ssh://USER@HOST/./immich-borg
  4. 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.

    bash
    borg key export ssh://USER@HOST/./immich-borg immich-borg-key.txt
  5. Salva lo script di backup

    Questo è lo script di Immich con la cifratura, un solo repository, sette archivi giornalieri conservati e il flag -t rimosso 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 cartella database-backup dentro 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-backup al posto della riga docker exec e aggiungi alla riga borg create il 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 puntare UPLOAD_LOCATION lì.

  6. Aggiungi la copia a casa

    Ripeti le righe create, prune e compact per 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.

  7. Eseguilo una volta, poi pianificalo con cron

    Esegui lo script a mano e leggi l'output. Poi esegui sudo crontab -e e aggiungi una riga che lo avvii ogni notte, qui alle 4:00, dopo il dump notturno di Immich.

    bash
    0 4 * * * /usr/local/bin/immich-borg.sh >> /var/log/immich-borg.log 2>&1
  8. 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 list dovrebbe 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.

bash
borg extract "$REPO::ARCHIVE-NAME" path/inside/the/archive/photo.jpg

Estrarre 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
  1. Immich VPS Hosting, DreamHost, 22 ott 2026. dreamhost.com/hosting/vps/immich
  2. VPS Hosting, DreamHost, 22 ott 2026. dreamhost.com/hosting/vps
  3. Cancel a VPS, DreamHost Help Center, 22 ott 2026. help.dreamhost.com/hc/en-us/articles/50609419977748-Cancel-a-VPS
  4. VPS overview, DreamHost Help Center, 22 ott 2026. help.dreamhost.com/hc/en-us/articles/50476238203028-VPS-overview
  5. Backup and Restore, Immich, 16 ott 2026. docs.immich.app/administration/backup-and-restore
  6. Backup Script, Immich, 16 ott 2026. docs.immich.app/guides/template-backup-script
  7. System Integrity, Immich, 16 ott 2026. docs.immich.app/administration/system-integrity
  8. Upgrading, Immich, 16 ott 2026. docs.immich.app/install/upgrading
  9. Post installation steps, Immich, 16 ott 2026. docs.immich.app/install/post-install
  10. FAQ, Immich, 16 ott 2026. docs.immich.app/FAQ
  11. Quick start, Immich, 16 ott 2026. docs.immich.app/overview/quick-start
  12. Requirements, Immich, 16 ott 2026. docs.immich.app/install/requirements
  13. Immich README, immich-app/immich on GitHub, 16 ott 2026. github.com/immich-app/immich
  14. Release v3.3.4, immich-app/immich on GitHub, 20 ott 2026. github.com/immich-app/immich/releases/tag/v3.3.4
  15. Quick Start, BorgBackup, 16 ott 2026. borgbackup.readthedocs.io/en/stable/quickstart.html
  16. borgbackup package versions, Debian, 16 ott 2026. qa.debian.org/madison.php?package=borgbackup&table=debian
  17. BorgBase plans, BorgBase, 19 ott 2026. borgbase.com

Hai bisogno di aiuto?

Che tu sia bloccato o semplicemente desideri alcuni consigli su dove iniziare, contatta i nostri esperti in qualsiasi momento. Siamo qui per aiutarti!

Aiuto Vendite DreamHost

24/7/365 Tramite il Widget di Chat

Chat di Supporto Clienti

24/7/365 Tramite il Pannello

Vai al Panel
Email di Supporto Clienti

24/7/365 Tramite il Pannello

Vai al Panel