This guide documents how to run Home Assistant OS on M1/M2/M3/M4 macOS devices using VMware Fusion, which became free to use as of 2024, and is a convenient and full-featured way to run the official HaOS disk image. I originally wrote this guide as a PR to update the current macOS installation page, however my change was rejected, so I’m posting it here instead. Hopefully that page will eventually be updated to include instructions for Apple Silicon devices.
To get started, download VMware Fusion by following this URL: Download and Install VMware Fusion
You’ll need to sign up for a Broadcom account and fill out a form when downloading the software, which could take a while due to a convoluted interface that they’ve implemented, there are more detailed instructions for downloading VMware Fusion online if you’re having trouble. After you’ve got it installed, follow these instructions:
- Download the Home Assistant OS image using this URL: Release Home Assistant OS 14.1 · home-assistant/operating-system · GitHub
- Select the file that has a name like this: haos_generic-aarch64-14.1.vmdk.zip, where 14.1 is the HaOS version
- Start VMware Fusion and select File > New from the menu bar.
- Select Create a custom virtual machine, then select Linux > Other Linux 6.x kernel 64-bit Arm.
- On Intel Macs, select Other Linux 6.x kernel 64-bit.
- Select Use an existing virtual disk and locate the unzipped disk image file.
- Ensure Make a separate copy of the virtual disk is selected in the file picker options.
- Select Customize Settings at the “Finish” step.
- Define the amount of memory and the number of cores the VM is allowed to use under Processors & Memory.
- Under General, you may choose to start the VM when your Mac boots up if preferred.
- Connect an Ethernet cable and ensure it is connected to your network.
- Under Network Adapter, select Ethernet under Bridged Networking.
- Under Hard Disk, increase the disk size to the recommended minimum.
- Under USB, select any USB devices that you want to pass through to Home Assistant, such as Home Assistant Connect, or other Zigbee/Z-Wave dongles. You may also want to choose to always connect the device to Home Assistant by choosing Connect to Linux in the Plug In Action dropdown.
Now you can close the settings window and start the VM. You’ll see the connection details on screen, and the onboarding process can be started by visiting the shown URL in your browser.