HowTo install Home Assistant (HA) OS in Proxmox VE (PVE) 7.1

HowTo install Home Assistant (HA) OS in Proxmox VE (PVE) 7.1

The definitive step-by-step guide to installing Home Assistant on a Proxmox VM

Habitats Tech's photo
Habitats Tech
·Feb 16, 2022·

5 min read

Subscribe to my newsletter and never miss my upcoming articles

In our past posts we covered PVE installation options. In this post we will explore the most effective installation option for Home Assistant. Home Assistant OS (HAOS) is possibly the best automation platform, especially for residential projects of any size, but also for any scale commercial projects as well.

If you are coming from relatively old-hat last-century automation platforms, like Control4, Crestron, Elan, Savant, etc you might be surprised to be informed we can design a system which has no single point of failure and can also self-heal (try that with any other system). Contact me if you would like to discover how we do things 21st-century style, open source, imagination is the limit.

Hopefully this should be the ultimate guide of installing HAOS in PVE.

So, let's dive into installing HAOS on PVE 7.1. Let's create the VM first. I assume you have already bare-metal installed PVE. If not, read my superguide prior to following the steps below.

Note: During a bare-matel install of PVE we can have the default filesystem as one of the following 4 options:

  • ext4 (the default)
  • xfs
  • zfs (if a robust filesystem is needed and have the necessary HW resources)
  • btrfs (technology preview stage)

image.png

image.png

local-lvm (FS=ext4) or local-zfs (FS=zfs).

  • image.png

  • image.png

From this point we assume PVE was installed with FS = zfs. If you install PVE with the default settings then when you see local-zfs from now on, you substitute with local-lvm. Therefore, you will only have one of two options: either local-lvm or local-zfs depending on filesystem installed during PVE bare-metal install.

image.png

image.png

image.png

image.png

DO NOT start after created.

image.png

Click Detach, as per screenshot below.

image.png

image.png

Click Remove, as per screenshot below.

image.png

image.png

Click Remove, as per screenshot below.

image.png

image.png

Select >_ Shell, as per screenshot below.

image.png

Before we carry on with the installation we need to find the latest HAOS download file for a KVM virtual machine, which has an extension .qcow2. Visit the HAOS GitHub page, go down the list of files and try to find a file named haos_ova-x.x.qcow2.xz (e.g. haos_ova-7.4.qcow2.xz). Make a note of the version number; in our example 7.4.

Once you have identified the version number, go back to >_ Shell and type the following commands.

Remember to substitute version number 7.4 below with the version number you have noted earlier.

wget https://github.com/home-assistant/operating-system/releases/download/7.4/haos_ova-7.4.qcow2.xz

image.png

The file haos_ova-7.4.qcow2.xz will start downloading. When download complete type the following two commands.

apt install xz-utils

image.png

unxz haos_ova-7.4.qcow2.xz

image.png

The above command will uncompress the qcow2 file, which we then have to attach to the VM (created above), with the below command. We assume the VMID created above is 100 and remember to change the HAOS version number if different from our example command below. As a reminder, if you have installed PVE with the defaults, filesystem = ext4, the storage pool name will be local-lvm. If, however, you installed with filesystem = zfs the storage pool name will be local-zfs. The command syntax is:

qm importdisk "VM-ID" "haos-image-name.qcow2" "storage-pool-name"

qm importdisk 100 haos_ova-7.4.qcow2 local-lvm

or

qm importdisk 100 haos_ova-7.4.qcow2 local-zfs

image.png

The last command will create a VM disk named vm-100-disk-0 under local-lvm/local-zfs,

image.png

which can also be found under

100 (HAOS) -> Hardware -> Unused Disk 0 (local-zfs:vm-100-disk-0)

image.png

We now have to attach the newly created disk to the VM 100 (HAOS). Highlight Unused Disk and click Edit, as per screenshot below.

image.png

Tick all necessary options and click Add, as per screenshot below.

image.png

Select 100 (HAOS) -> Options -> Boot Order and then click Edit., as per screenshot below.

image.png

Untick net0, tick scsi0 and click OK, as per screenshot below.

image.png

The boot order now is set to scsi0, which means the VM will start from the disk we created and attached earlier.

image.png

Our HAOS is ready to be activated. Right click on 100 (HAOS) and select Start, as per screenshot below.

image.png

Select Console and see HAOS being installed automatically. Wait until you see the login prompt as per below screenshot. You system has been setup as DHCP, something we will need to change when we explore HAOS configuration in our next post.

image.png

Note: HAOS provides the IPv4 address and hostname you have to use to access the web admin console of HAOS; in our example http://192.168.0.87:8123 and homeassistant.local:8123

Go to your browser and type any of the above two URLs to access the HAOS web admin console. My next posts will take you through the full process to successfully configure HAOS.

Note: our PVE installation above was on an SSD, which influences the best settings to use when setting up storage parameters. If you are installing on a HDD or slower than SSD medium you should not select when creating the VM:

  • Discard
  • SSD emulation
  • IO thread

Please consider subscribing to my blog, as you will only ever get quality content; no time wasting, advertising, spamming or other unproductive activities/practices.

Please also consider visiting and subscribing to our YouTube channel; we have recently started posting videos.

We are committed to improving and enhancing over time.

If there is something you would like us to cover in a future topic/guide please let us know.

Important Note: From time to time we enhance the content of our posts. It is therefore recommended you link to our original post in our blog.habitats.tech, by either subscribing to our blog.habitats.tech or visiting our subreddit reddit.com/r/HabitatsTech (our posts in Reddit link to our original posts).

 
Share this