スタックを再作成すると、Home Assistantが永続データにアクセスできなくなるのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

同じ永続的な/configデータを再びマウントすれば、Home AssistantのDockerまたはComposeスタックを再作成しても、設定が消えることはありません。再作成後に初期設定が表示されたり、インテグレーションが見つからなくなったりした場合は、まずHome Assistantが家庭内の状態データを削除したのではなく、新しいコンテナから異なるストレージが見えていると考えてください。

古いバックアップを復元する前に、有効なマウント、ホストパス、名前付きボリューム、隠しファイル、権限を確認してください。空の間違ったディレクトリは、元のデータがホスト上の別の場所にそのまま残っていても、設定が失われたように見えることがあります。

/configに実際にマウントされているものを確認する

実行中のコンテナを調べ、/configに割り当てられたマウント元を確認してください。見覚えのあるフォルダー名だけに頼らず、以前のComposeファイルやデプロイ記録と照合してください。

Dockerのバインドマウントは、コンテナから見える対象ディレクトリを置き換えます。最新のバインドマウントのドキュメントでは、ホストのディレクトリをコンテナ内の空でないパスにマウントすると、そこに元からあったファイルが隠れると説明されています。そのため、ソースパスが空、または誤っていると、Home Assistantには空の/configが見えることになります。

マウントが正しいと確認できるまでは、初期設定を進めたり、新しいインテグレーションを追加したりしないでください。間違ったディレクトリへの書き込みが増えると、後の復旧がさらに複雑になります。

バインドマウントと名前付きボリュームを見分ける

Composeスタックでは、明示的なホストパスまたはDocker管理の名前付きボリュームを使用できます。プロジェクト名、ボリューム名、またはパスを変えてプロジェクトを再作成すると、古いボリュームが残ったまま、新しい空の永続ストレージが作られることがあります。

最新のDockerボリュームガイドによると、名前付きボリュームは個々のコンテナとは独立してデータを保存し、コンテナを置き換えた後も再接続できます。そのため、コンテナの削除と永続ストレージの削除や置き換えは別の操作です。

古いボリュームと新しいボリュームの一覧を確認し、Docker経由でマウントポイントを調べて、作成日時と内容を比較してください。どのボリュームにHome Assistantの正規の状態データがあるか分かるまで、pruneコマンドは実行しないでください。

隠しファイルのせいで、コピーが完全に見えても実際には不完全なことがある

Home Assistantは、.storageなどの隠しパスに、UIで管理される重要な状態を保存します。*のようなグロブを使ったシェルでのコピーや、ドットファイルを非表示にするファイルマネージャーでは、YAMLファイルだけが移動され、重要なレジストリやインテグレーションの状態が気付かないうちに取り残されることがあります。

2025年のDockerからComposeへの移行事例でも、まさにこの境界で同じ問題が再現しました。コピー処理でHome Assistantの隠し状態の一部がコピーされなかった、または正しく処理されず、設定ツリー全体とメタデータを正しくコピーした後にのみ移行が安定しました。

ドットファイルを含むディレクトリ一覧を比較し、データ自体が破損していると判断する前に、所有権、タイムスタンプ、想定される隠しディレクトリの有無を確認してください。

データを再コピーする前に権限を確認する

再作成したコンテナに読み取りまたは書き込み権限がないと、正しいディレクトリでも使用できないように見えることがあります。データを新しいファイルシステムに移動した場合、Dockerのモードを変更した場合、別のホストから復元した場合、またはUID/GIDのマッピングを変更した場合によく発生します。

2026年に検証されたDocker Engineのトラブルシューティングガイドでは、こうした障害の原因として実際のホストパス、コンテナのUID/GID、親ディレクトリへのアクセス、マウントモード、セキュリティ境界に絞り込んでいます。ファイルが見えていても、読み取り専用設定や所有権の不一致によってHome Assistantが状態を更新できないことがあります。

設定ツリー全体に全ユーザー書き込み権限を設定するのではなく、必要最小限の所有権またはマウントの問題を修正してください。

永続化パスを確認してからスタックを再作成する

問題なく動作していたCompose定義、イメージタグ、ネットワークモード、デバイス、/configのソースをそのまま使用します。Home Assistantを起動し、マイグレーションや新たな設定変更を許可する前に、想定されるユーザー、ダッシュボード、インテグレーション、自動化、ヘルパーが戻っていることを確認してください。

ZimaSpaceの単一コンテナの復旧手順にも同じルールが当てはまります。スタック内の無関係な部分を復元または置き換える前に、実際に適用されているマウントを確認し、正常な依存関係を再接続してください。

正式なデータが本当に見つからない場合は、バックアップからの復元に進みます。データが存在するのに新しいコンテナから参照または変更できない場合、問題はHome Assistantの設定そのものではなく、ストレージのマッピングまたは権限の境界にあります。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.