After finishing our Proxmox installation, it’s time to install Home Assistant. To install Home Assistant on Proxmox, we’ll use a script by tteck that automates most of the process. This customizable script eliminates the need for manual VM deployment.
Installation Steps
Select your VM on the left of your Proxmox menu and choose Shell, this will open a terminal window. Then copy and run the following command:
bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm.sh)"The wizard will prompt you to confirm the creation of a Home Assistant OS VM. Select “Yes” to continue.
On the next screen, you may choose either Default settings or Advanced. Default settings are usually sufficient, but you can allocate more RAM and storage if needed. For Advanced settings, you can select:
- Home Assistant OS version (Stable is recommended)
- Virtual Machine ID (You may leave it as it is)
- Machine type (Leave it default)
- Disk Cache (Leave it default)
- Hostname (this cannot contain an underscore)
- CPU Model (Leave it default)
- Allocate CPU cores (2 is sufficient for Home Assistant)
- Allocate RAM (4096 is sufficient for Home Assistant)
- Set a Bridge (Leave it default)
- Set MAC Address (Leave it default)
- Set a VLAN (Leave it default)
- Set MTU Size (Leave it default)
- Start VM when completed (You may choose “Yes”)
Select the final “Yes” to confirm. Wait for the script to download, extract, and install the latest KVM image of Home Assistant OS. Once you receive a “Completed Successfully” message, the installation is done.
Accessing Your Home Assistant on Proxmox
To find the IP address assigned to your Home Assistant VM instance:
- Click your node on the left.
- Select your newly created Home Assistant VM.
- The IP address will be displayed in the middle. Use this IP to access Home Assistant in your web browser (e.g., 192.168.xxx.xxx:8123).
Optional: USB Passthrough to Home Assistant on Proxmox
While using Home Assistant on Proxmox you’ll need to enable USB Passthrough to be able to use a Zigbee or Z-Wave dongle:
- Plug in your USB device to your Mini PC.
- Select your Home Assistant VM on the left.
- Choose “Hardware” from the menu, then click “Add” at the top bar and select “USB Device.”
- Select “Use USB Vendor/Device ID” from the menu, choose your USB device, and click “Add.”
- Reboot the VM by pressing the small arrow next to Shutdown and selecting “Reboot.”
Your USB dongle will be auto-discovered in Home Assistant, allowing you to set up your integrations.
Optional: Set CPU Scaling Governor
To adjust CPU speed for energy saving or performance:
Open the Proxmox Shell and run the following script:
bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/scaling-governor.sh)"The script will display the current scaling governor. Set it to “powersave” if desired.
Ensure to set up a cron job on the next screen for persistent CPU scaling governor configuration across reboots. Select “Yes,” followed by “OK,” and reboot Proxmox.
Optional: Set a Static IP Address
For a consistent IP address in your router’s DHCP settings:
- Open your Home Assistant instance.
- Navigate to Settings > System > Network.
- Click “IPv4” and select “Static.”
- Set the IP, Gateway, and DNS, then click “Save.”
This is it, you’ve successfully completed installing Home Assistant on Proxmox, good job!