Contents
Mac mini M4でHome Assistantを導入する前に準備すること
Mac mini M4でHome Assistantを構築する際には、事前準備が成功の鍵です。特にmacOS SonomaとDocker環境の整備は、後々のトラブルを防ぐために不可欠です。このセクションでは、導入前のチェックポイントを解説します。
macOS Sonomaのバージョン確認
Home Assistantの動作環境として最新のmacOS Sonomaが推奨されています。以下の手順で現在のバージョンを確認してください：
- メニューから「Appleロゴ」→「このMacについて」を選択
- 「概要」タブでmacOSバージョンを確認（例: macOS 14.0 Sonoma）
Docker Desktop for Macのインストール前提条件
Home AssistantはARM64アーキテクチャに対応したDockerイメージを使用します。以下の環境が整っている必要があります：
- macOS Sonoma (14.x以上)
- Apple Siliconチップ（M1/M2/M4）
- メモリ8GB以上
注意：公式リポジトリから最新バージョンのDocker Desktopをダウンロードし、インストール前にアプリケーションの権限設定を確認してください。
M1/M2/M4チップ対応のHome Assistantイメージ選定方法
ARMベースのDockerイメージを選択する際には、適切なタグ選定が性能に大きく影響します。以下に判断材料を示します。
ARMベースのDockerイメージの識別方法
公式リポジトリ（https://hub.docker.com/_/home-assistant）では、タグ名にarm64v8/が含まれるものがApple Silicon対応です。例: arm64v8/homeassistant:latest
公式リポジトリでのタグ選択基準
| 項目 | 推奨値 | 補足 |
|---|---|---|
| バージョン | latestまたは特定バージョン（例: 2026.8.1） |
最新バージョンは安定性を重視する |
| ベースイメージ | arm64v8/ubuntuまたはalpine |
パフォーマンスとメモリ使用量のバランス |
| 構成ファイル | configuration.yaml |
定義済みでない場合は事前に作成 |
ポイント：ARM64イメージを使用しないと、コンテナ実行時に「アーキテクチャ不一致エラー」が発生する可能性があります。
macOS SonomaでDocker環境を構築する手順
macOS SonomaでのDockerセットアップは、Home Assistantの安定した運用に不可欠です。以下のステップに従ってください。
Docker Desktopのインストール手順
- Docker公式サイトから「Download Docker Desktop for Mac」をクリック
- ダウンロードした
.dmgファイルをマウントし、アプリケーションフォルダにドラッグ - 「起動」アイコンをダブルクリックし、インストール完了後、「Docker Desktop」を起動
ARM64アーキテクチャ対応の確認コマンド
以下のコマンドでDockerがARM64環境に対応しているか確認します：
|
1 2 3 |
docker run --rm hello-world # 出力例: Hello from Docker! This message shows that your installation appears to be working correctly. |
注意：インストール直後はDockerデーモンが起動していない場合があります。タスクトレイのDockerアイコンをクリックし、「Start Docker Desktop」を選択してください。
ホームアシスタントの初期設定画面操作ガイド
Home Assistantの初期設定では、Webブラウザからのアクセスと基本プロファイル作成が重要です。以下に手順を解説します。
Webブラウザからのアクセス方法
- Docker Desktopで「ホームアシスタント」コンテナを起動（または
docker-compose up -dコマンドで起動） - Webブラウザのアドレスバーに
http://localhost:8123を入力 -
「Setup Wizard」画面が表示されるので、以下の項目を順番に入力してください：
-
Country（国）
- Language（言語）
- Time Zone（時刻設定）
基本プロファイルの作成手順
- 「User name」と「Password」を設定し、「Next」をクリック
- 「Integration」画面でホームデバイスを追加（例: ライティングコントローラやセンサー）
- 「Continue」を選択し、自動的にUIが更新されます
コツ：初期設定時に「Supervisor」の有効化を忘れずに。これはコンテナ管理機能で、定期的なアップデートに必要です。
ローカルネットワーク接続時のファイアウォール設定
ホームアシスタントサーバーへのアクセスを許可するためには、macOSのファイアウォール設定とポート開放が不可欠です。以下の手順で確認してください。
macOSのファイアウォール設定手順
- 「システム設定」→「セキュリティとプライバシー」→「ファイアウォール」タブを開く
- 「ファイアウォールを有効にする」チェックボックスをオンに
- 「詳細オプション」をクリックし、「ホームアシスタント」にアクセス許可を付与
ポート開放の確認コマンド
以下のコマンドで、8123ポートが開放されているか確認します：
|
1 2 3 |
sudo pfctl -s rules | grep 8123 # 出力例: anchor "com.apple.private.ports" { load anchor "com.apple.private.ports" from "/etc/pf.d/anchor-com.apple.private.ports.conf" } |
ポイント：ポート開放が必要な場合は、
sudo pfctl -F a -f /etc/pf.confでルールを再読み込みしてください。
注意: macOS Sonomaではpfctlの動作が変更されている可能性があります。代替として「セキュリティとプライバシー」設定でポートを開く方法も検討してください。
定期更新用cronジョブの作成方法
Home Assistantは公式リポジトリから最新バージョンを定期的に取得する必要があります。以下の手順でcronスクリプトを作成します。
bashスクリプトによる自動更新手順
以下のようにバックアップ処理を追加し、データロスのリスクを軽減してください：
-
update_ha.shファイルを作成し、以下を記載します：
bash
#!/bin/bash
docker pull arm64v8/homeassistant:latest # ARM64用イメージを使用
cp -r /path/to/config /path/to/backup_config # バックアップ処理追加
docker stop ha
docker rm ha
docker run -d --name ha -p 8123:8123 arm64v8/homeassistant:latest -
実行権限を付与：
chmod +x update_ha.sh
crontabの編集コマンド
以下の手順でcronジョブを登録します：
|
1 2 3 4 |
crontab -e # 以下を追加（例: 毎月1日0時実行） 0 0 1 * * /path/to/update_ha.sh |
注意：更新周期は過剰な負荷を避けるため、週1回程度が推奨されます。スクリプトのエラーログには
/var/log/cron.logを指定してください。
ARM64サポート確認: Docker Desktop for Mac v4.27以降でARM64が完全対応していることを事前に確認してください。
ARM64互換性の再確認方法
Docker Desktop for MacのバージョンによってARM64サポートが変動する可能性があるため、以下のように確認してください：
- Docker Desktopアプリケーションで「Preferences」→「Resources」タブを開く
- 「Processor」セクションに「Use the Apple silicon CPU」が選択されているか確認
- 「About Docker Desktop」画面でインストールバージョンを確認（例: v4.27以上推奨）
注意: 一部の旧バージョンではARM64イメージが正常に動作しない場合があります。公式サイトから最新版をダウンロードしてください。