Running a Home Assistant Operating System [HAOS] VM in Proxmox VE 🌱

  1. Log into the Proxmox web UI
  2. Right click the Proxmox node name > Create VM
  3. Give the VM a unique ID (note the ID for later) and Name > Next
  4. On the OS tab, Select Do not use any media, leave the Type as Linux and the Version as 5.x - 2.6 Kernel > Next
  5. On the System tab, set the BIOS field to OVMF (UEFI), Check the Add EFI Disk checkbox, Uncheck the Pre-Enroll Keys checkbox > Next
  6. On the Hard Disk tab, delete the scsi0 virtual disk > Next
  7. On the CPU tab, set Cores to 2 or more and Type to host > Next
  8. On the Memory tab, set the Memory to 2048 > Next
  9. Leave the defaults on the Network tab > Next
  10. Verify the summary and click Finish
  11. Click the Proxmox node name > Select Shell from the left sub-navigation menu
  12. Run the following commands in the web console
    # install unxz
    apt update && apt install xz-utils -y
    # lookup the latest HAOS release download URL
    regex='"browser_download_url": "(https:\/\/github.com\/home-assistant\/operating-system\/releases\/download\/[^/]*\/haos_ova-[^/]*\.qcow2\.xz)"' && response=$(curl -s https://api.github.com/repos/home-assistant/operating-system/releases/latest) && [[ $response =~ $regex ]] && downloadURL="${BASH_REMATCH[1]}"
    # download the qcow virtual disk
    wget -O /tmp/HAOS.qcow2.xz $downloadURL
    # extract the downloaded virtual disk
    unxz /tmp/HAOS.qcow2.xz -v
    # attach the disk to the HAOS VM
    # update the ID to match the ID of the HAOS VM created earlier
    # the last argument is the name of the storage device to import the disk to
    qm importdisk 104 /tmp/HAOS.qcow2 SSD_100GB
  13. Back in the Proxmox web UI, select the HAOS VM > Select Hardware from the left sub-navigation menu
  14. Double click the Unused Disk > Click Add
  15. Click Options from the left sub-navigation menu
  16. Double click Boot Order to edit it > Check the Enabled box next to scsi0 and drag it above net0 > Click OK
  17. Click Start at the top right of the screen to start the VM
  18. Click Console in the left sub-navigation menu
  19. Welcome to Home Assistant Operating System
  20. Open a web browser and navigate to http://DNSorIP:8123
  21. Enter a Name, Username and Password to create a Home Assistant user account > Click Create Account
  22. Enter a Name for this Home Assistant installation (ie Home)
  23. Click Detect to set the installation geolocation
  24. Verify the Unit System and Currency > Click Next
  25. Select any anonymous data to share with the Home Assistant development team > Click Next
  26. Click Finish
  27. Welcome to Home Assistant