Skip to content
  1. Blog
  2. Network

Network#自宅サーバー#TrueNAS#仮想マシン

TrueNAS SCALEのVMにHome Assistant OSを入れる手順と、VNC画面が開かないときの対処

UIが少し独特なTrueNAS SCALEの仮想マシン(VM)機能にHome Assistant OS(HAOS)を導入する手順。 zvol作成とqemu-img書き込み、起動時のPermission denied、0.0.0.0:5900のVNC表示の対処をまとめました。

Written by the site’s operator1 min read
TrueNAS エンタープライズ/SCALE サーバー筐体
TrueNAS SCALE の仮想マシン機能上に Home Assistant OS(HAOS)を立ててVNCコンソールやネットワーク設定を行う際の全体イメージ。

ミニPCの自宅NASでTrueNAS SCALEを動かしていると、ついでにスマートホーム用のハブであるHome Assistant OS(HAOS)も同居させたくなります。ただ、TrueNASのVM(仮想マシン)作成画面はESXiやProxmoxと少し作り方が違っていて、いくつか引っかかりやすい箇所がありました。実際に導入して起動するまでに踏んだポイントと手順を整理しておきます。

1. 先にzvolを作って、イメージを流し込む

TrueNAS SCALEのVMは、ディスクイメージファイル(.qcow2 など)をそのままマウントするのではなく、先にストレージ側で zvol(ブロックデバイス領域)を作ってから、そこへ生データを書き込むのが標準の手順になります。

  1. TrueNASの「Storage」を開き、対象のプールから Add Zvol を選んで32GBほどの領域(例:tank/haos-disk)を作ります。
  2. 「System」→「Shell」を開き、公式のKVM/Proxmox向け .qcow2.xz イメージをダウンロードして解凍し、qemu-img convert でzvolに書き込みます。
HAOSイメージを解凍してzvolへ変換書き込みする手順(tank部分は自分のプール名に合わせる)bash
cd /tmp
wget https://github.com/home-assistant/operating-system/releases/download/12.1/haos_ova-12.1.qcow2.xz
xz -d haos_ova-12.1.qcow2.xz
qemu-img convert -O raw haos_ova-12.1.qcow2 /dev/zvol/tank/haos-disk
rm haos_ova-12.1.qcow2
  1. その後、VMの新規作成ウィザードのディスク設定で「Use existing disk image」を選び、作成した tank/haos-disk を割り当てます。
TrueNAS SCALE で HAOS VM を起動し VNC 接続エラーを回避するフロー図解
VNCポートやBindアドレス(0.0.0.0 vs NAS IP)、UEFI Secure Boot 設定の2点を押さえると初回起動からすんなり入る。

2. 起動時に引っかかりやすい2つのエラー

CallError: Permission denied で起動しないとき

VMを作るときに「既存のzvol」を指定したつもりで、裏側に別経路のRAWファイルやデータセット直下のパスを参照する不要なデバイスが紛れ込んでいると、起動時に Permission denied が出て止まります。

VM一覧の「Devices」を開き、意図した ZVOL 以外に余計な DISK デバイスが残っていないか確認して削除すると正常に起動するようになります。

「0.0.0.0:5900」と出てブラウザで画面が開かないとき

VMを起動して「ディスプレイ」ボタンを押したとき、Webブラウザ上にコンソール画面が開かず、Connect using a VNC client to: 0.0.0.0:5900 という案内だけが出ることがあります。また、シリアルシェルを開いても Connected to domain... だけで画面が動かないように見えて焦りやすいです。

このときの 0.0.0.0 は「すべてのIPで待機中」という意味なので、PC側に無料の外部VNCクライアント(RealVNC ViewerやUltraVNCなど)を入れて、接続先に「TrueNASのIPアドレス:5900」(例:192.168.x.x:5900)を直接入力すると、Home Assistantの起動画面が普通に表示されます。

同じTrueNAS環境でのバックアップとTailscale接続については、TrueNASのZFS ReplicationエラーとTailscaleサブネット設定もあわせて参考にしてみてください。

Tools for this article

Share this article
Share on X

Read next

Network

ミニPCのNASでHDDが54℃。激安サーマルパッドと3Dプリントのファンで31℃まで下げた記録

ThinkCentre TinyにTrueNASを入れ、7200rpmの2.5インチHDDを積んだら54℃に。折り曲げたサーマルパッド、アルミホイル、 激安パッドの重ね貼り、3Dプリンターで作った上乗せファンまで、smartctlの温度で追った体験記。温度とSMARTを確かめるコマンドつき。

#自宅サーバー#ストレージ
Network

TrueNAS SCALEのZFS Replicationのreadonlyエラーと、Tailscaleで自宅LANにつなぐ設定

TrueNAS SCALEでZFSのレプリケーション(複製バックアップ)を組んだときに出やすい「readonly=on」エラーの原因と解消法、 およびTailscaleを使って外出先からNASだけでなくLAN内のルーターや他機器へアクセスするための設定をまとめました。

#自宅サーバー#TrueNAS
Network

VPNはどこまで通せて、なぜ全部は抜けないのか。TrueNAS上のTailscaleが学校フィルタリングで止まる仕組み

「VPNを繋げばどんな制限も回避できる」わけではない理由を、Tailscale(WireGuard)の通信構造・Exit Node・UDP遮断・DPI(ディープパケットインスペクション)・VPNプロトコルごとの違いから整理した。

#VPN#Tailscale
Essays & Notes

AI文章っぽい定型句を避けて、ChatGPT過去ログの「実測と失敗」を一次記事にする

AI生成文章に出やすい導入定型句の傾向を確認しつつ、一般論の焼き直しではなく自分のChatGPTエクスポートに眠る実機検証や失敗談をブログ記事へ起こす編集方針をまとめた。

#ライティング#ブログ運営
Essays & Notes

なぜ減価償却で「100万円使って赤字」ではなく1円(備忘価額)を残すのか

設備投資した年の現金支出(キャッシュフロー)と本業の稼ぐ力(損益計算)を切り分ける減価償却の意味と、償却完了後に帳簿へ1円(備忘価額)を残す理由、建物の定額法統一を整理した。

#会計#減価償却
Essays & Notes

「6時半」に違和感がないのにデンマーク語の20進数を奇妙に感じるのはなぜか

時(24進)+分(60進)+半(2進)の雑種である「6時半」は自然なのに、デンマーク語の50・70・90の20進数表現を難しく感じる理由を「パターン認識と文化バイアス」から考察した。

#数学#認知科学

All articles