Skip to content

Home Assistant OS

I've used this community post as a starting off point for installation.

Enable VM's in unRAID

Before installing this you'll need to enable VM's in unRAID.

You can install the USB manager to easily passthrough individual USB devices to your Home Assistant VM (or other VMs).

  1. Go to Apps
  2. Search for 'USB Manager'
  3. Install 'USB Manager'

Get qcow2 image

  1. Download the latest qcow2.xz image from the Home Assistant OS Release page on GitHub.
  2. Extract this xz archive into your unRAID server. I choose the share domains

Setup Home Assistant VM

  1. Add a VM
  2. Choose the number of CPU cores you want to assign to the VM
  3. Choose the amount of RAM you want to assign to the VM
  4. Primary vDisk location choose Manual and point it to the qcow2 file
  5. Set Primary vDisk Bus to SATA
  6. Click Create

Setup USB passthrough

USB manager required

For this step USB manager is required.

For each device you want to passthrough:

  1. Click on Device Settings 🖥️
  2. Select the Home Assistant Virtual Machine
  3. Enable "Auto Connect at USB Device Plugin"
  4. Enable "Auto Connect to VM at VM Start"
  5. Click Done
Conbee II incompatibility

For the Conbee II to work properly using the USB Manager on unRAID you'll need to enable "Connect as Serial Only". For more information, see also this unRAID forum post, this Home Assistant community post and this Reddit post.

Start VM

Finally you can start the VM. USB devices should connect automatically, as configured. You can use VNC to monitor your VM.