Communityoplossing

Duplicati-service niet beschikbaar op ZimaOS: herstel de defecte instellingendatabase zonder back-ups te verwijderen

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.

Op pagina 3 ging deze lange supportthread niet langer voornamelijk over op afstand inloggen. Het concrete probleem was inmiddels een Duplicati-container die actief was, maar werd geopend als Service Unavailable. Het logboek gaf de belangrijkste aanwijzing: de instellingendatabase was aangemaakt zonder een geldige SETTINGS_ENCRYPTION_KEY, en het achteraf wijzigen van omgevingsvariabelen had de al aangemaakte configuratiestatus niet hersteld.

De oplossing uit de community was bewust beperkt: verwijder en maak de Duplicati-container opnieuw aan, wis alleen de configuratiedatabase, laat de back-upbestemming en bronmappen ongemoeid en maak Duplicati vervolgens één keer opnieuw aan met een echte sleutel voor instellingenversleuteling. De oorspronkelijke poster antwoordde later: “Ik ben binnen,” waarmee werd bevestigd dat deze herstelprocedure de toegang had hersteld.

De Duplicati-app in ZimaOS met een foutmelding Service Unavailable bij het opstarten
De oorspronkelijke Duplicati-container leek aanwezig in ZimaOS, maar de WebUI kon niet correct starten.

Het Duplicati-logboek wees op de ontbrekende sleutel voor instellingenversleuteling

Het bronlogboek eindigde met:

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

Dat is veel sterker bewijs dan gokken naar poorten of externe toegang tot ZimaOS. De fout zat in de toepassings- en configuratielaag van Duplicati.

De instellingssleutel is niet hetzelfde als het wachtwoord voor back-upversleuteling

  • SETTINGS_ENCRYPTION_KEY beschermt de lokale instellingendatabase van Duplicati;
  • het wachtwoord voor back-upversleuteling beschermt de inhoud van back-ups;
  • het inlogwachtwoord van de WebUI is weer een afzonderlijke inlogmethode.

Bewaar deze geheimen in een wachtwoordmanager in plaats van een zwakke testwaarde zoals 1234 opnieuw te gebruiken.

Duplicati-appinstellingen in ZimaOS met configuratieback-up en bronvolumes plus SETTINGS_ENCRYPTION_KEY
De oorspronkelijke configuratie combineerde applicatie-instellingen, back-upopslag en bronmappen. Daarom is het bij herstel extra belangrijk om alleen het configuratiepad te verwijderen.

Verwijder de back-upbestemming niet

In de bron werd nadrukkelijk gewaarschuwd om de back-upgegevens en bronmappen niet aan te raken. De reset richtte zich uitsluitend op de Duplicati-configuratiedatabase in het AppData-configuratiepad. Het verwijderen van een container betekent niet automatisch dat back-ups worden verwijderd wanneer de back-upgegevens in een afzonderlijke gekoppelde hostmap zijn opgeslagen.

Maak de container opnieuw aan met een geldige sleutel

  1. stop en verwijder de defecte Duplicati-container;
  2. maak eerst een back-up en wis daarna alleen de Duplicati-configuratiedatabase;
  3. stel een sterke SETTINGS_ENCRYPTION_KEY in;
  4. maak de container opnieuw aan;
  5. open de WebUI en controleer of de installatie normaal start.

Omdat dit om probleemoplossing uit de community gaat, moet je de actuele volumekoppelingen controleren voordat je een configuratiemap verwijdert.

Combineer App Store-installaties niet met handmatige Docker-installaties

Eerder in dezelfde thread maakte de gebruiker per ongeluk handmatig een tweede Duplicati-container aan terwijl ook de App Store werd gebruikt. Daardoor ontstond onduidelijkheid over poorten en configuraties. Kies één installatiemethode en gebruik één leidend configuratiepad.

Duplicati is een archiefback-up, geen doorzoekbare spiegel

In de bronbespreking werd later verduidelijkt dat Duplicati blokken en metagegevens opslaat. De bestemming hoort er niet uit te zien als een normale kopie van elke bronmap; herstellen gebeurt via Duplicati.

Test zowel het herstel van één bestand als dat van een map voordat je de back-up voor productiegegevens vertrouwt.

Verwar Duplicati niet met ZimaOS Backup

ZimaOS heeft ook een eigen systeem voor geplande en versiegebaseerde back-ups. Duplicati is nuttig wanneer je specifiek Duplicati's versleutelde archiefformaat en ondersteuning voor bepaalde bestemmingen wilt; de ingebouwde Backup-app is eenvoudiger wanneer de ondersteunde bronnen en bestemmingen aan de vereisten voldoen.

Gebruik de actuele ZimaOS Backup-workflow.

Veelgestelde vragen over Duplicati Service Unavailable

Bevestigde de gebruiker uit de bron dat de toegang was hersteld?

Ja. Nadat de configuratie en sleutel waren opgelost, zei de oorspronkelijke poster dat die toegang had tot Duplicati.

Moet ik mijn Duplicati-back-upbestanden verwijderen om de WebUI te repareren?

Nee. De oplossing uit de bron richtte zich uitsluitend op de defecte configuratiedatabase, niet op de back-upbestemming of brongegevens.

Is SETTINGS_ENCRYPTION_KEY het back-upwachtwoord?

Nee. Deze sleutel beschermt de lokale instellingendatabase van Duplicati en staat los van versleuteling van de back-upinhoud.