Soluzione della community

Servizio Duplicati non disponibile su ZimaOS: reimposta il database delle impostazioni danneggiato senza eliminare i backup

Page 3 of a long January 2026 thread had moved from remote-login and storage problems into a Duplicati startup failure. Logs showed a missing SETTINGS_ENCRYPTION_KEY. A community reply advised recreating only the Duplicati config database with a valid key while preserving sources and backups; the original poster then confirmed they could get into Duplicati.

A pagina 3, questa lunga discussione di supporto non riguardava più principalmente l’accesso remoto. Il problema concreto era diventato un container Duplicati in esecuzione, ma che si apriva mostrando Service Unavailable. Il suo log forniva l’indizio decisivo: il database delle impostazioni era stato creato senza un SETTINGS_ENCRYPTION_KEY valido e la modifica successiva delle variabili d’ambiente non aveva corretto lo stato di configurazione già creato.

La soluzione della community era volutamente circoscritta: rimuovere e ricreare il container Duplicati, cancellare solo il suo database di configurazione, lasciare intatte la destinazione del backup e le cartelle sorgente, quindi ricreare Duplicati una sola volta con una vera chiave di crittografia delle impostazioni. In seguito, l’autore del post originale ha risposto: «Sono riuscito ad accedere», confermando che la procedura di ripristino aveva riottenuto l’accesso.

Applicazione Duplicati di ZimaOS che mostra un errore di avvio Service Unavailable
Il container Duplicati originale appariva presente in ZimaOS, ma la sua WebUI non riusciva ad avviarsi correttamente.

Il log di Duplicati ha identificato la chiave di crittografia delle impostazioni mancante

Il log originale terminava con:

Missing encryption key, unable to encrypt your settings database
Please set a value for SETTINGS_ENCRYPTION_KEY and recreate the container

Si tratta di una prova molto più solida rispetto a fare ipotesi sulle porte o sull’accesso remoto a ZimaOS. Il problema si trovava nel livello applicativo e di configurazione di Duplicati.

La chiave delle impostazioni non è la stessa password di crittografia del backup

  • SETTINGS_ENCRYPTION_KEY protegge il database locale delle impostazioni di Duplicati;
  • la password di crittografia del backup protegge il contenuto del backup;
  • la password di accesso alla WebUI è un’altra credenziale distinta.

Conserva questi segreti in un gestore di password invece di riutilizzare un valore di test debole come 1234.

Impostazioni dell’app Duplicati di ZimaOS che mostrano il backup della configurazione, i volumi sorgente e SETTINGS_ENCRYPTION_KEY
La configurazione originale combinava impostazioni dell’applicazione, archiviazione dei backup e cartelle sorgente; per questo era particolarmente importante eliminare solo il percorso di configurazione durante il ripristino.

Non eliminare la destinazione del backup

La discussione originale avvertiva esplicitamente di non toccare i dati del backup o le cartelle sorgente. Il ripristino riguardava solo il database di configurazione di Duplicati nel percorso di configurazione AppData. La rimozione del container non comporta automaticamente l’eliminazione dei backup quando questi sono archiviati in una cartella host separata e mappata.

Ricrea il container con una chiave valida

  1. arresta e rimuovi il container Duplicati danneggiato;
  2. esegui il backup, quindi cancella solo il database di configurazione di Duplicati;
  3. imposta un SETTINGS_ENCRYPTION_KEY sicuro;
  4. ricrea il container una sola volta;
  5. apri la WebUI e verifica che la configurazione venga avviata normalmente.

Poiché si tratta di una procedura di risoluzione dei problemi fornita dalla community, verifica gli attuali mapping dei volumi prima di eliminare qualsiasi directory di configurazione.

Non combinare installazioni dallo store delle app e installazioni Docker manuali

In precedenza, nella stessa discussione, l’utente aveva creato accidentalmente un secondo container Duplicati manualmente mentre utilizzava anche lo store delle app. Questo aveva generato ambiguità relative a porte e configurazione. Scegli un solo metodo di distribuzione e mantieni un unico percorso di configurazione autorevole.

Duplicati è un backup ad archivi, non un mirror consultabile

La discussione originale ha chiarito in seguito che Duplicati archivia blocchi e metadati. Non ci si deve aspettare che la destinazione abbia l’aspetto di una copia normale di ogni cartella sorgente; i ripristini vengono eseguiti tramite Duplicati.

Prova sia il ripristino di un singolo file sia quello di una cartella prima di affidare al backup dati di produzione.

Non confondere Duplicati con Backup di ZimaOS

ZimaOS dispone anche di un proprio sistema di backup pianificato e con versioning. Duplicati è utile quando desideri specificamente il suo formato di archivio crittografato e il supporto alle relative destinazioni; l’app Backup integrata è più semplice quando le sue sorgenti e destinazioni supportate soddisfano il requisito.

Consulta l’attuale procedura di Backup di ZimaOS.

Domande frequenti su Duplicati Service Unavailable

L’utente originale ha confermato il ripristino dell’accesso?

Sì. Dopo la risoluzione dei problemi relativi alla configurazione e alla chiave, l’autore del post originale ha dichiarato di essere riuscito ad accedere a Duplicati.

Devo eliminare i file del backup Duplicati per correggere la WebUI?

No. La soluzione originale riguardava solo il database di configurazione danneggiato, non la destinazione del backup né i dati sorgente.

SETTINGS_ENCRYPTION_KEY è la password del backup?

No. Protegge il database locale delle impostazioni di Duplicati ed è separata dalla crittografia del contenuto del backup.