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

ZimaOSでアドオン付きの完全なHome Assistantを実行する

A January 2026 ZimaOS discussion clarified that Home Assistant features depend on the installation type, not the ZimaOS version. Docker provides Home Assistant Container without Supervisor/add-ons, while one user confirmed full Home Assistant OS running inside ZVM.

Supervisor、アプリ/アドオン、バックアップ、Home Assistantが管理する更新を含む「完全な」Home Assistant体験を求めるなら、重要なのは特定のZimaOSバージョンではなく、Home Assistantのインストール方式の選択です。これは、2026年1月のIceWhale Communityスレッドで示された中心的な回答でした。

Home Assistant ContainerはZimaOS上でDockerアプリケーションとして通常どおり実行できますが、現在のHome Assistantドキュメントでは、ContainerインストールはHome Assistantアプリにアクセスできないと明記されています。ZimaOSを維持しながらHAOSの完全な体験も得たい場合、情報源に基づく最も有力な妥協案は、Home Assistant Operating Systemを仮想マシンとして実行することです。コミュニティユーザーがZVM内で実行し、HACSとアドオンにアクセスできたと報告しています。

Home Assistantの3つの実用的な選択肢

方式 ZimaOSを維持できるか Supervisor/アプリ 最適な用途
ZimaOS内のHome Assistant Container はい いいえ サポートコンテナを自分で管理したいユーザー
ZVM内のHome Assistant OS はい はい ZimaOSを維持しながら完全なHA体験
Home Assistant OSのベアメタル いいえ、同じディスクにインストールする場合 はい 専用のHome Assistantマシン

オプション1:ZimaOS上のHome Assistant Container

ZimaOS上でDockerを通じてHome Assistantをインストールすると、Home Assistant Containerを実行することになります。これはコンテナ内でHome Assistant Coreを提供する、公式にサポートされたHome Assistantのインストール方式です。

現在のHome Assistantドキュメントには、次のように明記されています。

  • Home Assistant Containerは、Dockerまたはその他のOCI互換ランタイム上で実行されます。
  • Home Assistant Supervisorは含まれません。
  • Home Assistantのアプリ/アドオンは提供されません。
  • サポートサービスと更新はご自身で管理します。

現在のリファレンス:Home Assistant Generic x86-64インストールガイド。

「アドオンなし」でも、MQTT、ESPHome、その他のサービスを実行できないという意味ではありません

多くのHome Assistantアドオンは、通常のDockerコンテナとしても利用できるソフトウェアをラップしたものです。ZimaOS上のHome Assistant Containerでは、MQTTブローカー、ESPHome、Node-RED、データベースなどのサービスを別のコンテナとして実行できる場合があります。

違いは管理方法です。Home Assistant Supervisorは、これらのコンテナをHome Assistantアドオンとしてインストール、更新、監視、バックアップ、統合することはありません。Dockerのライフサイクル管理はご自身で行う必要があります。

オプション2:ZVMでHome Assistant OSをVMとして実行する

ソーススレッドの後の返信では、ZimaOSに特化した最も有用な回答が示されました。コミュニティメンバーのZimaRatは、Home Assistantの仮想マシンイメージをダウンロードしてZimaOSにコピーし、ZVMを開いてカスタムインストールを選択し、ZimaOS Filesからイメージを選択して、Home Assistant OSをVMとして起動したと述べています。

HAOSの初期化後にHACSとアドオンをインストールできたと報告されています。別の経験豊富なコミュニティメンバーも、これはZimaOSを維持しながら完全なHAOS体験を得る有効な方法だと同意しました。

VM方式でHome Assistantの完全な体験が得られる理由

Home Assistant OSは、完全なアプライアンスOSです。ハードウェア仮想マシン内で実行しても、独自の仮想ディスクとHome Assistant Supervisor環境を引き続き管理します。

これは、ZimaOS内でHome AssistantアプリケーションだけをDockerコンテナとして起動する方法とは根本的に異なります。

現在のHome Assistantドキュメントでは、サポート対象のハイパーバイザー上でHAOSを仮想マシンとして正式にサポートしており、次のようなイメージが提供されています:

  • VirtualBox .vdi;
  • KVM/Proxmox .qcow2;
  • VMware .ova.

公式リファレンス:Home Assistant OS仮想マシンのインストールガイド。

ソースのユーザーはZVMでVirtualBoxイメージを使用した

コミュニティの返信では、Home Assistantの「Alternative installation」ページにあるVirtualBoxイメージを使用し、解凍してZimaOSにコピーし、ZVMから選択したと具体的に説明されています。

これは、2026年版のZVMで確認されたコミュニティの事例です。今後のすべてのZVMビルドが、すべてのHome Assistantイメージ形式を変更なしでサポートすると一般化して主張すべきではありません。新しいVMを作成する際は、現在のZVMインターフェースで受け付けられるイメージ形式を使用してください。

VMのリソース要件

Home Assistantの現在のVMガイドに記載されている最小要件:

2 GB RAM
2 vCPU

より負荷の高いアドオン、音声処理、データベース、カメラ、大規模な自動化ワークロードを使用する予定がある場合は、より多くのリソースを割り当ててください。

すべてのホストリソースをHAOS VMに割り当てるのではなく、ZimaOSとその他のアプリケーション用に十分なCPUとメモリを確保してください。

Zigbee、Z-Wave、USB無線デバイスにはパススルーが必要

ソースの返信では、ZVM上のHAOSにおける1つのトレードオフが正しく指摘されています。ZigbeeやZ-Waveのコーディネーターなどの物理USBデバイスは、VMにパススルーする必要があります。

無線アダプターがHAOS内で認識されなければ、ホスト上のZimaOSがUSBデバイスを検出していても、Home Assistantはそれを使用できません。

VM構成を採用する前に、現在のZVMリリースが自動化機器に必要なUSBパススルーをサポートしていることを確認してください。

オプション3:ZimaOSをHome Assistant OSに置き換える

ミニPCをHome Assistant専用にする場合は、ハードウェアへHAOSを直接インストールすることで、最もシンプルな完全版Home Assistant環境を構築できます。

ただし、元のスレッドでは、インストールを「USBにHAOSをフラッシュしてインストールする」と単純化して説明していました。後のユーザーが正しく指摘したように、HAOSには、USBから起動して内蔵ディスクへ自分自身を書き込む従来型のインストーラーはありません。

現在のHome Assistantドキュメントには、次のように記載されています。

HAOSには、イメージを自動的に書き込む統合インストーラーはありません。

汎用x86-64ハードウェアでは、ライブUbuntu USBから起動し、「ディスク」ユーティリティを使ってHAOSディスクイメージを対象の内蔵ディスクへ復元する方法が推奨されます。別の方法として、別のコンピューターから対象の起動メディアへHAOSディスクイメージを直接書き込むこともできます。

ZimaOSのディスクにHAOSをインストールするとZimaOSは消去されます

Home Assistant OS自体がオペレーティングシステムです。現在WindowsまたはZimaOSが入っている物理ドライブにHAOSイメージを書き込むと、その対象ドライブ上の古いOSとデータは上書きされます。

まずデータをバックアップしてください。「Home Assistantアプリのインストール」と「Home Assistant OSのインストール」は、まったく異なる操作です。

2台の物理ディスクに分けて両方を維持できますか?

コミュニティの返信では、1台のディスクにZimaOSを、別のディスクにHome Assistant OSを入れ、ファームウェアで起動デバイスを選択する方法も言及されていました。これならもう一方のOSを上書きせずに済みますが、両方の環境を同時に稼働させることとは異なります。

1台のマシンでZimaOSと完全なHome Assistantを同時に実行したい場合は、HAOSをZVM内で動かす方法のほうが実用的です。

ベアメタルHAOSではハードウェア/ファームウェアの互換性に違いが生じる可能性があります

後の参加者は、ZimaBoard用に外付けNVMeへHAOSを書き込んだものの、同じNVMeが別のシステムでは起動したにもかかわらず、そのハードウェアではカーネルオフセット/起動エラーが発生したと報告しました。

このスレッドでは、確実に機能する普遍的な解決策は確立されませんでした。この結果は、ベアメタルのHAOSがすべてのx86 Zimaデバイスで保証されると説明すべきではない、もう一つの理由です。UEFI、セキュアブート、ストレージコントローラー、ファームウェアの動作が影響します。

現行のGeneric x86-64 HAOS要件

Home Assistantの現行ガイドでは、次の要件が求められています:

  • 64ビットのIntel/AMDシステム。
  • UEFIブートモード。
  • セキュアブートを無効にする。
  • 専用の起動ディスクまたは起動メディア。
  • 初期設定用のネットワーク/インターネットアクセス。

HAOSの起動後、通常は次の場所でHome Assistantを利用できます:

http://homeassistant.local:8123

またはVM/デバイスのIPアドレスのポート経由で 8123.

どの方法を選ぶべきですか?

次の場合は、ZimaOS上のHome Assistantコンテナを選択してください:

  • Dockerをすでに問題なく管理できる。
  • Supervisor管理のアドオンが必要ない。
  • VMのオーバーヘッドを最小限に抑えながら、多数の通常のZimaOSアプリとHome Assistantを併用したい。

次の場合は、ZVM上のHome Assistant OSを選択してください:

  • SupervisorとHome Assistantのアドオン/アプリエコシステムを利用したい。
  • 同じマシンでZimaOSを稼働し続けたい。
  • VMリソースの割り当てとUSBデバイスのパススルーに抵抗がない。

次の場合は、ベアメタル版のHome Assistant OSを選択してください:

  • そのマシンをHome Assistant専用にする。
  • そのマシンでZimaOSを使用する必要がない。
  • 最もシンプルで、公式に推奨されているHome Assistantアプライアンスモデルを求めている。

ZimaOSで完全版のHome Assistantを利用する際のチェックリスト

  1. Supervisor/アドオンが本当に必要かどうかを判断してください。
  2. そうでなければ、ZimaOS上のHome Assistantコンテナで十分な場合があります。
  3. はい、かつZimaOSを維持したい場合は、ZVMでHAOS VMを作成してください。
  4. VMワークフローでサポートされている、現行のHome Assistant OS VMイメージを使用してください。
  5. 少なくとも2 GBのRAMと2基のvCPUを割り当ててください。負荷の高いワークロードでは、さらに多く割り当てます。
  6. Home Assistantで必要な場合は、Zigbee/Z-Wave/USBデバイスをパススルーしてください。
  7. VM内でHAOS独自のバックアップ機能を使用してください。
  8. HAOSをベアメタルにインストールする場合、イメージを書き込むと対象ディスクのOSが置き換えられることを理解しておいてください。

ZimaOSで完全版のHome Assistantを利用する際のFAQ

どのZimaOSバージョンでHome Assistantのアドオンが有効になりますか?

特定のZimaOSバージョンで可能になるものはありません。アドオンの利用可否は、Home Assistantコンテナではなく、Home Assistant OS/Supervisorを実行しているかどうかによって決まります。

ZimaOSのHome Assistant Dockerアプリではアドオンをインストールできますか?

いいえ。現在のHome Assistantのドキュメントによると、コンテナインストールではHome Assistantのアプリ/アドオンにアクセスできません。

ZVMで完全版のHome Assistantを実行できますか?

元のスレッドには、HACSとアドオンを利用した、ユーザー確認済みのHAOSのZVM構成が含まれています。これをコミュニティで確認されたZimaOSのワークフローとして扱い、現在のZVMイメージとUSBパススルーのサポートを確認してください。

Home Assistant OSをインストールするとZimaOSは消去されますか?

はい。現在ZimaOSが入っている同じ物理ディスクにHAOSを書き込む場合です。VMでHAOSを実行すれば、その置き換えを回避できます。