Troubleshooting and Additional Information
Permission denied
The following errors (or similar) when trying to download, extract, or install HAOS using the TrueNAS shell are typically caused by insufficient user permissions.
haos_ova-9.5.qcow2.xz: Permission denied
Cannot write to ‘haos_ova-9.5.qcow2.xz’ (Permission denied).
unxz: haos_ova-9.5.qcow2: Permission denied
qemu-img: /dev/zvol/tank/vm/haos: error while converting raw: Protocol driver 'host_device' does not support image creation, and opening the image failed: Could not open '/dev/zvol/tank/vm/haos': Permission denied
You may need to run the commands as root or use sudo
sudo wget https://github.com/home-assistant/operating-system/releases/download/9.5/haos_ova-9.5.qcow2.xz
sudo unxz haos_ova-9.5.qcow2.xz
sudo qemu-img convert -O raw haos_ova-9.5.qcow2 /dev/zvol/tank/vm/haos
Cannot grow device files
This can happen when the ZVOL is not sized correctly.
qemu-img: /dev/zvol/tank/vm/haos: error while converting raw: Cannot grow device files
Confirm the size of your ZVOL is at least 32 GiB
VM is booting to the UEFI Interactive shell
This happens if we use the incorrect path when writing the HAOS image to our zvol. Notice in the following command that the path starts with /dev/zvol
qemu-img convert -O raw haos_ova-11.5.qcow2 /dev/zvol/tank/vm/haos
If you’re still having trouble, please reply with the exact command you used for this step.
Using the ConBee II Zigbee Controller
Unfortunately, the Conbee II is known to not work with USB Passthrough.
You still have a few options, though:
- Use PCIe passthrough to connect the USB controller to the VM.
- Use this script to start your VM. (this gets old fast)
- The final option is to get another Zigbee controller