How to Set Up Home Assistant on Proxmox

In this tutorial, we’re going to look at how to install Home Assistant on Proxmox.

There are technically two different ways to set up Home Assistant on Proxmox and we’re going to look at both below. The first way is automated, meaning that you run a script and it will walk you through the different options that you can use. This is incredibly easy, however, many people don’t feel comfortable running scripts, so we’ll look at how to manually install it as well.

How to Set Up Home Assistant on Proxmox

The two options that we’ll look at below will show you how to set up Home Assistant on Proxmox using a script (first option and automated) or manually.

How to Set Up Home Assistant on Proxmox – Automated

1. Review the script that we’ll be running below and ensure you’re comfortable proceeding. To give you my personal input, I have used this every time I’ve set up Home Assistant on Proxmox, but you should review it on your own as well.

NOTE: You can also check out ttecks GitHub page here (creator of the script)!

2. Access the Shell of your Proxmox server.

proxmox shell icon.

3. Run the command below to install Home Assistant.

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm-v4.sh)"
running the command above in the proxmox shell.

4. Select Yes to create a new Home Assistant VM.

creating a home assistant VM.

5. If you’d like to use the default settings, you can, however, I normally select No to configure my Home Assistant setup.

selecting no on the default settings of home assistant.

6. Select the version that you’d like to use.

selecting the stable version of home assistant.

7. Set a virtual machine ID (this can generally stay as-is).

setting a virtual machine ID.

8. Set the hostname that you’d like to use.

creating a VM hostname.

9. Allocate the total number of CPU cores.

allocating CPU cores in proxmox.

10. Allocate the total memory that the VM should have.

setting the memory to use in proxmox.

11. This section will ask you to configure the bridge network. Leave this as default (though your screenshot may look different) and select OK.

selecting the bridge network to use.

12. Leave the MAC Address as default and select OK.

confirming the mac address in proxmox.

13. If you’re using a VLAN and would like this virtual machine to use that VLAN, you’ll have to enter the VLAN tag here. However, if you don’t have VLANs set up, you can select OK.

defining a vlan tag to use.

14. Select Yes to start the VM when it’s finished installing.

confirming the vm should start when completed.

15. Finally, select Yes to create the virtual machine!

selecting yes to create the vm.

16. Home Assistant will now download and install!

vm install progress.

17. Once it finishes installing, you can open the console window for the VM and view the IP address that was assigned or access home assistant by the Home Assistant URL. After connecting to the URL, you’ll have to finish setting up Home Assistant, but it will be ready to go afterward!

confirming the vm shell is up and running.

How to Set Up Home Assistant on Proxmox – Manually

After looking at how to set up Proxmox using a script, you might not be comfortable running a script that is written and maintained by someone else. The process below will be slightly more involved but will walk you through how to set up Home Assistant on Proxmox manually.

1. Navigate to the Home Assistant downloads page and download the KVM/Proxmox (.qcow2) file.

downloading the proxmox qcow2 file.

2. Extract the file, then rename it from .qcow2 to .img on your Mac/PC. This step is important because our goal is to upload it to our ISO images library, then import it into our virtual machine and the ISOs directory doesn’t traditionally store .qcow2 images.

renaming the qcow2 image to img.

3. After you rename the file, upload it to your ISO Images location.

uploading the iso image to proxmox.

4. Select Create VM and then enter a name.

addinga  vm name and vm ID.

5. In the OS tab, select do not use any media.

selecting not to use any media.

6. In the System tab, check off QEMU Agent.

confirming the settings in proxmox.

7. In the Disks tab, delete (red trash can) the scsi0 disk. You shouldn’t have any disks listed after doing this.

removing the scsi0 disk.

7. Set the CPU tab to use two cores.

setting the CPU cores in proxmox.

8. Set the Memory to use 4GB.

setting the memory in proxmox.

9. Navigate to the Confirm tab and ensure that Start After Created is NOT selected. Then select finish to create the virtual machine.

confirming the virtual machine settings in proxmox.

10. Run the command below substituting the current version, VM ID, and Storage Location. After running the command below, the disk will be imported into your VM!

NOTE: If you’re using a separate location for your ISOs like a Synology NAS, you’ll have to navigate to that storage location. Once again, you might have to update the version below to match what you downloaded.

qm importdisk <VMID> /var/lib/vz/template/iso/haos_ova-8.4.img <STORAGE_LOCATION>
navigating to the iso image folder and importing it to the VM.

11. Select the virtual machine and edit the unused disk that we just imported.

viewing and editing the unused disk just imported in proxmox.

12. Select Add to add the disk to the VM.

adding the hard disk to the VM in proxmox.

13. Next, select Add and then EFI Disk. Select your EFI Storage, uncheck pre-enroll keys, then select OK.

selecting where to add the disk.

14. Finally (for the hardware changes), select Edit on the BIOS and set it as OMVF (UEFI).

changing the BIOS setting to UEFI.

15. Select Options, then Edit the boot order.

editing the boot order in proxmox.

16. Uncheck ide2 and net0 and then check scsi0. Select OK to save these settings.

enabling the new disk and disabling everything else.

16. You can now start the virtual machine! It will take a little while to boot up the first time.

starting the VM.

17. Once it finishes booting, you can open the console window for the VM and view the IP address that was assigned or access Home Assistant by the Home Assistant URL. After connecting to the URL, you’ll have to finish setting up Home Assistant, but it will be ready to go afterward!

how to set up home assistant on proxmox - VM is installed properly and accessible by IP address.

Conclusion – How to Set Up Home Assistant on Proxmox

This tutorial looked at how to set up Home Assistant on Proxmox. The two options above will have the exact same end result, meaning that Home Assistant will be installed and you’ll be able to use the supervised version. However, the way that you go about them is entirely different. Depending on if you’re comfortable running scripts on your Proxmox server, that will probably determine if you’d like to use the first option.

Thanks for checking out the tutorial on how to set up Home Assistant on Proxmox. If you have any questions on how to set up Home Assistant on Proxmox, please leave them in the comments!