Installing Home Assistant OS using Proxmox 8
(Previously Installing Home Assistant OS using Proxmox 7)
This guide will assist in installing Home Assistant on x86/64 machines using Proxmox as the operating system. It has been tested and verified on several machine types including Dell Optiplex SFF 990, Dell Optiplex USFF 780, and HP T520 thin client.
This guide uses scripts, by using a script, the installation process can be streamlined and simplified, making it easier for users to get up and running with Home Assistant OS on Proxmox VE. However, caution should be exercised when using scripts and automations from third-party sources. The source code for the scripts used in this guide can be viewed by following the link provided at the bottom.
The Home Assistant team provides an official KVM image for this installation, making it a supported and recommended method. While considered an easy/medium difficulty installation, basic familiarity with Linux is recommended.
To backup your current Home Assistant configuration for later restoration, refer to the documentation on backing up and restoring your configuration as well as some additional information HERE.
Section 1 - Installing Proxmox VE 8
1.1) Before proceeding with the installation, make sure that UEFI Boot & Virtualization is enabled and Secure Boot is disabled in your machine’s BIOS.
1.2) Download the Proxmox VE 8.x ISO Installer.
1.3) You will now need to make a bootable USB drive using balenaEtcher. Using a USB drive of at least 8gb, insert it into your PC, open Etcher, select the Proxmox VE image you just downloaded, select your USB drive, then click Flash.
1.4) Insert the bootable USB drive you just made into the machine you wish to install Proxmox VE on. Connect a monitor, Ethernet cable, keyboard, mouse, and power on the machine. If the machine doesn’t boot from the USB drive automatically, you will need to enter the boot options menu by pressing Esc, F2, F10 or F12, (This relies on the company of the computer or motherboard) on your keyboard immediately when the machine is powering on.
1.5) When you see the first screen, select Install Proxmox VE (Graphical) or Install Proxmox VE (Console) (With many newer generation CPUs, such as Intel 12th Gen and subsequent models, the graphical installation process may encounter difficulties in initiating) and press Enter. The installer will perform some automated tasks for 1-2 minutes.
1.6) On the EULA screen, select, I Agree.
1.7) On the Proxmox Virtualization Environment (PVE) screen, you will get the option to choose which disk you want to install Proxmox VE on. When finished, click Next.
1.8) On the Location and Time Zone selection, Type your country, then select your time zone and change the keyboard layout if needed. When finished, click Next
1.9) On the Administration password and E-mail address screen, choose a password (make sure you don’t forget it), confirm your password and enter a valid email address. When finished, click Next
1.10) On the Management network configuration screen.
- Management interface Should auto populate with the network interface (Ethernet) of your machine. If not, select the network interface.
- Hostname (FQDN) - The first part of the hostname is what your node will be called under Datacenter, you might want to change this to something more friendly now, the default is “pve” (eg. proxmox.lan).
- IP Address - Should auto populate. If the IP address looks odd here and not at all like the address range of your other devices, it’s possible you may not be connected to your network, so check your network cable and start again.
- Netmask - Should auto populate and be something like
255.255.255.0
depending on your network configuration. - Gateway - Should auto populate to the IP address of your router. If not, make sure you’re connected to your network
- DNS server - Should auto populate to the same IP address as your gateway. Or, input one of your choosing. When finished, click Next
1.11) Next on the Summary screen, confirm that all of the details are correct. When confirmed click Install.
Proxmox VE will install and is finished once it displays its IP address on the screen. Take note of the IP address! It’s needed to access Proxmox via a web browser. Remove the USB drive, and click Reboot. While the machine is rebooting, you can unplug the monitor, keyboard and mouse, as they’re no longer needed.
1.12) After 1-2 minutes, you should be able to access Proxmox VE via a web browser using the noted IP address from above (eg. http://192.168.1.10:8006
) If you see a message “Warning: Potential Security Risk Ahead”, you can safely ignore this, accept the risk and continue. Login with User name: root
and the password you created on the Administration password and E-mail address screen.
Section 2 - Configuring and Updating Proxmox VE
This script provides options for managing Proxmox VE repositories and more, including disabling the Enterprise Repo, adding or correcting PVE sources, enabling the No-Subscription Repo, adding the test Repo, disabling the subscription nag, updating Proxmox VE to the latest version, applying security patches, and rebooting the system, making it easier and quicker to install Home Assistant OS.
2.1) To complete the post-installation process for Proxmox VE, copy and run the following command in the Proxmox Shell.
bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/post-pve-install.sh)"
It is recommended to answer “yes” (y) to all options presented during the process.
Section 3 - Installing Home Assistant OS
This script automates the process of creating a Virtual Machine (VM) using the official KVM (qcow2) disk image provided by the Home Assistant Team. It involves finding, downloading, and extracting the image, defining user-defined settings, importing and attaching the disk, setting the boot order, and starting the VM. It supports various storage types, and does not involve any hidden installations.
3.1) To install the Home Assistant OS virtual machine, copy and run the following command in the Proxmox Shell.
bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm.sh)"
3.2) The default settings can be used for most users, but advanced options for changing network settings such as mac, bridge, vlan and MTU are available for those who need them. The time it takes to complete the installation will vary based on your internet connection and the capabilities of your machine.
Upon completing the installation process, a message of “✓ Completed Successfully!” will appear to confirm its successful completion.
3.3) To find the IP address of a virtual machine in Proxmox VE, go to the Summary tab of the VM. Then, using the obtained IP address, access the Home Assistant interface by entering http://[ip_address]:8123
into a web browser.
Once you have reached the login screen on Home Assistant, the initial setup process is finished. At this point, you can create a new account with a chosen username and password. If you are a first-time user of Home Assistant, you can then proceed to set up any smart devices that the system has automatically detected on your network. If you have a previous installation of Home Assistant and a backup of your configuration, refer to the Home Assistant website for instructions on restoring your setup using the backup file, located HERE as well as some additional information HERE
Feel free to reach out to me via tag or private message with any suggestions for improving this guide. Your feedback is welcomed.
The scripts mentioned are created by @tteck and can be accessed on the GitHub repository located at GitHub - tteck/Proxmox: Proxmox VE Helper Scripts.