アップグレード中にHome Assistantの設定が失われないようにする方法

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

内蔵バックアップシステムを主要な復旧手段とし、実行環境は交換可能なものとして扱うことで、Home Assistantの設定消失を防ぎましょう。Home Assistantのバージョン、コンテナイメージ、ホストは変更される可能性があります。元のマシンが失われても、バックアップ、暗号化キー、実行時の定義、外部依存関係を利用できる状態にしておく必要があります。

最新のHome Assistantバックアップは、Containerを含むあらゆるインストール形式に対応しています。必要に応じて設定ツリーの手動コピーも別途保管できますが、サポート対象のバックアップ・復元ワークフローを無視して、ファイルの手動コピーだけを中心にアップグレード計画を立てないでください。

手動でコピーしたYAMLフォルダーではなく、内蔵バックアップから始める

「設定」をconfiguration.yamlだけに限定して考えてはいけません。Home Assistantがサポートするバックアップシステムでは、設定やデータベースの内容など、復旧に必要なアプリケーションの状態が保存されます。また、新しいバックアップのワークフローでは、自動化、保持期間の設定、ホスト外の保存先にも対応しています。

2025年に導入されたバックアップ機能の刷新により、暗号化バックアップの自動作成、保持期間の設定、オフサイトのバックアップ先が利用できるようになりました。不完全な手動コピーに頼るのではなく、アップグレード前にまず内蔵バックアップを検証することが重要です。

それでも、設定ルート、データベースの選択、シークレットの参照先、カスタムコンポーネント、SSL関連ファイル、インテグレーションが必要とする外部ファイルやサービスは記録しておきましょう。バックアップでHome Assistantの状態を復元できても、周辺にあるすべてのUSBデバイス、ネットワークパス、データベースホスト、コンテナパラメーターまで自動的に記録されるわけではありません。

コンテナの永続化と実行設定を明確にする

Dockerでは、/configを管理するバインドマウントまたはボリュームを確認し、ネットワークモード、デバイスのマッピング、タイムゾーン、権限、外部サービスを再現するComposeまたはrunの定義を保管してください。コンテナのファイルシステム自体は、いつでも破棄できる状態にしておきましょう。

Home AssistantのDockerバックアップに関する議論では、障害の原因がはっきり示されています。ユーザーが完全なconfigディレクトリではなく、ファイルだけをマウントすると、重要な状態がコンテナ内に取り残され、実行環境の置き換え時に失われることがあります。

アップグレード前にホストのマウントを確認し、実行時の定義をバックアップと一緒に保管してください。アプリケーションの状態と、無線デバイス、ポート、ネットワーク、ストレージを利用可能にするための手順があらかじめ分かっていれば、復旧が大幅に早くなります。

暗号化バックアップを少なくとも1つホスト外に保管する

同じSSD上のバックアップは一部の設定ミスからは保護できますが、ホストの喪失、ファイルシステムの破損、盗難、ストレージデバイスの故障には対応できません。少なくとも1つの復旧用コピーをNAS、別のコンピューター、または故障したHome Assistantホストにアクセスを依存しないリモートのバックアップ先に保管してください。

バックアップの暗号化キーまたは緊急キットも、Home Assistantの外に保管してください。Home Assistant 2026.4では、新たに作成する暗号化バックアップが監査済みのSecureTar v3形式と、より強力で現代的な暗号化方式に移行しました。これによりバックアップのセキュリティは向上しますが、復旧可能性を確保するうえでキーの保管が明確な要件となります。

バックアップは同じファイルに上書きせず、バージョンごとに保存してください。アップグレード後、数日経ってから問題が判明することもあり、その時点では最新の復旧ポイントに、避けたい移行済みまたは破損した状態がすでに含まれている可能性があります。

バックアップだけではランタイム定義の代わりにならない

設定だけでは、USB無線アダプター、ホストネットワーク、タイムゾーン、デバイスパススルー、データベースサービス、MQTT、リバースプロキシとの接続関係を復元できない場合があります。ランタイムの再作成に必要なComposeファイル、イメージのバージョン方針、環境変数、ホストパス、デバイスマッピング、サービス依存関係を保持してください。

Composeファイルにバージョン管理を適用するためだけに、平文のシークレットを公開リポジトリに入れないでください。シークレットの値は保護された場所に保管し、復旧プロセスでどこから取得するかだけを記録してください。

ZimaSpaceのZimaBoardでのHome Assistant導入ガイドは、ホームサーバープラットフォームと、今後の導入変更後も維持する必要のあるアプリケーションの状態を切り分けるうえで参考になります。

アップグレードが緊急事態になる前に復元テストを実施する

アーカイブが存在するだけでは、バックアップの有効性は証明されません。隔離した環境または一時コンテナに復元し、実際の環境に即したデバイスやパスを可能な範囲で再接続して、ユーザー、ダッシュボード、連携機能、自動化、ヘルパー、期待される状態とともにシステムが復旧することを確認してください。

本番システムがまだ動作しているうちにテストを実施し、パスワードの不足、古くなったホストパス、文書化されていないデバイスマッピング、肥大化したデータベースを見つけましょう。テストが成功したら復元手順を記録してください。記憶だけでは復旧計画になりません。

アップグレードの直前に新しい復旧ポイントを作成し、現在のHome Assistantのバージョンとコンテナイメージを記録して、連携機能に影響するリリース変更を確認してください。アップグレードしたインスタンスが通常の使用時間と再起動の両方を問題なく乗り切るまで、以前のランタイムを利用できる状態に保ってください。

4項目のアップグレード安全性チェックを実施する

復旧用資産 保護する対象 欠落時の障害
内蔵バックアップ Home Assistantの設定と復元可能なアプリケーションの状態 サポート対象の復元ポイントがない
暗号化キー / 緊急キット 保護されたバックアップへのアクセス バックアップはあるが開けない
ランタイム定義 マウント、デバイス、ネットワーク、環境 状態は正しいのにサービスにアクセスできない
オフホストのコピー + 復元テスト ホスト障害と手順の妥当性 本番環境とともに復旧手段が失われる、または必要なときに機能しない

4つすべてが揃っている場合にのみアップグレードしてください。設定ツリーを手動でコピーして予備の保護層として残すことはできますが、主な復旧計画には、サポート対象のバックアップを使い、文書化されたランタイムとともに復号・復元できるようにしてください。

サポートとヒント

続きを読む

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.