コミュニティソリューション

ZimaOSでDuplicatiのサービスが利用できない場合:バックアップを削除せずに壊れた設定データベースをリセットする

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.

3ページ目までに、この長いサポートスレッドの主題は、もはやリモートログインではありませんでした。実際に対処すべき問題は、起動しているにもかかわらずService Unavailableと表示されるDuplicatiコンテナでした。ログには重要な手がかりがあり、SETTINGS_ENCRYPTION_KEYが有効な値なしで設定データベースが作成され、その後に環境変数を変更しても、すでに作成済みの設定状態は修復されていないことが示されていました。

コミュニティで示された修正方法は、意図的に対象を限定したものでした。Duplicatiコンテナを削除して再作成し、設定データベースだけを消去し、バックアップ先とソースフォルダーには手を付けず、実際の設定暗号化キーを指定してDuplicatiを一度だけ再作成します。投稿者は後に「入れました」と返信し、この復旧手順でアクセスが回復したことを確認しました。

Service Unavailableの起動エラーが表示されたZimaOSのDuplicatiアプリ
元のDuplicatiコンテナはZimaOS上に存在していましたが、WebUIを正常に起動できませんでした。

Duplicatiのログが設定暗号化キーの不足を特定した

元のログは次の内容で終わっていました。

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

これは、ポートやZimaOSのリモートアクセスを推測するよりもはるかに強い証拠です。問題はDuplicatiのアプリケーション/設定レイヤー内で発生していました。

設定キーはバックアップ暗号化パスワードとは異なる

  • SETTINGS_ENCRYPTION_KEYはDuplicatiのローカル設定データベースを保護します。
  • バックアップ暗号化パスワードはバックアップ内容を保護します。
  • WebUIのログインパスワードは、さらに別の認証情報です。

1234のような弱いテスト用の値を使い回すのではなく、これらのシークレットはパスワードマネージャーに記録して管理してください。

設定バックアップ、ソースボリューム、SETTINGS_ENCRYPTION_KEYが表示されたZimaOSのDuplicatiアプリ設定
元の設定にはアプリケーション設定、バックアップ保存先、ソースフォルダーが混在していたため、復旧時には設定パスだけを削除することが特に重要でした。

バックアップ先を削除しない

元の投稿では、バックアップデータやソースフォルダーには触れないよう明確に注意していました。リセットの対象は、AppDataの設定パスにあるDuplicatiの設定データベースだけでした。バックアップデータが別のホストフォルダーにマッピングされている場合、コンテナを削除してもバックアップが自動的に削除されるわけではありません。

有効なキーを指定してコンテナを再作成する

  1. 問題のあるDuplicatiコンテナを停止して削除する。
  2. バックアップを取ったうえで、Duplicatiの設定データベースだけを消去する。
  3. 強力なSETTINGS_ENCRYPTION_KEYを設定する。
  4. コンテナを一度だけ再作成する。
  5. WebUIを開き、セットアップが正常に開始されることを確認する。

これはコミュニティによるトラブルシューティングであるため、設定ディレクトリを削除する前に、実際の現在のボリュームマッピングを確認してください。

App Store版と手動Dockerインストールを混在させない

同じスレッドの前半で、ユーザーはApp Storeを使いながら、誤ってDuplicatiのコンテナを手動でもう1つ作成していました。その結果、ポートと設定が不明確になりました。デプロイ方法は1つに決め、正式な設定パスも1つに統一してください。

Duplicatiは閲覧可能なミラーではなくアーカイブバックアップ

その後の元の議論では、Duplicatiがブロックとメタデータを保存することも明らかになりました。保存先が、すべてのソースフォルダーを通常のコピーのように表示することは想定されていません。復元はDuplicatiを通じて行います。

本番データのバックアップを信頼する前に、単一ファイルの復元とフォルダーの復元の両方をテストしてください。

DuplicatiとZimaOS Backupを混同しない

ZimaOSには、スケジュール実行とバージョン管理に対応した独自のBackupシステムもあります。Duplicatiは、暗号化アーカイブ形式や保存先の対応など、Duplicati固有の機能を必要とする場合に便利です。一方、対応するソースと保存先が要件に合うなら、組み込みのBackupアプリのほうが簡単です。

現在のZimaOS Backupワークフローを使用してください。

DuplicatiのService Unavailableに関するFAQ

元のユーザーはアクセスが回復したことを確認しましたか?

はい。設定とキーに関するトラブルシューティングの後、投稿者はDuplicatiに入れたと述べています。

WebUIを直すためにDuplicatiのバックアップファイルを削除すべきですか?

いいえ。元の修正で対象にしたのは壊れた設定データベースだけであり、バックアップ先やソースデータではありません。

SETTINGS_ENCRYPTION_KEYはバックアップパスワードですか?

いいえ。Duplicatiのローカル設定データベースを保護するキーであり、バックアップ内容の暗号化とは別のものです。