Hassio Docker Raspberry Pi 4

A bit behind the original timeline, but we happy to announce, we’ve released version 3 of Hass.io Operating System: HassOS. Just in time for Christmas!

TL;DR; A quick summary of the changes:

  1. Update: There is a new official OS for Raspberry Pi boards: Raspberry Pi OS, which is available in both 32-bit and 64-bit variants. Check out how to install Docker and Docker Compose on Raspberry Pi OS in the updated article. This post is the definitive guide on using Docker on a Raspberry Pi, something I wish I had one week ago.
  2. Raspberry Pi Docker¶ Since the official Docker image isn’t compatible with Raspberry Pi, you will need to build your own docker image from the downloaded repository.
  3. Follow the installation instructions and you will end up with a Raspberry Pi 3B or 3B+ running hass.io in docker but instead of being based on HassOS or ResinOS, based on Raspbian! There are a couple of limitations such as the hass.io ssh addon does not work but there is a community addon as an alternative.
  4. For a long time I've been using Ubuntu with Docker for my HomeAssistant setup, but when trying to get that working on my Pi 4 I realized that my regular 'install docker, install portainer and grab hassio' did not work. I could easily just grab the HassOS-image for RPi 4, but I want an OS.
  • Official RPi4 support
  • Linux LT 4.19
  • Buildroot LT 2019
  • USB-boot capabilities for the RPi3
  • SMS integrations with USB/GSM modem
  • Qemu Agent support
  • Optimized kernel for virtual appliances
  • Improved automatic disk expansion
  • Initial foundation for offloading the data partition

We now officially support the Raspberry Pi 4 on this stable version of HassOS! The Raspberry Pi 4 is a great and powerful device to get you started on Hass.io and Home Assistant. @rbray89 worked hard on this release to add the very often requested USB boot support! Please note, this is currently limited to RPi3 devices.

Raspberry Pi

We now officially support the Raspberry Pi 4 on this stable version of HassOS! The Raspberry Pi 4 is a great and powerful device to get you started on Hass.io and Home Assistant.

@rbray89 worked hard on this release to add the very often requested USB boot support! Please note, this is currently limited to RPi3 devices. Carefully read how the USB boot works and be aware of the limited supported hardware.

Hypervisors / Running HassOS on a Virtual Machine

The HassOS image for virtual appliances did get some useful updates as well. We have optimized the Linux kernel to support more virtual hardware.

We have now included the QEMU Agent in HassOS. So if you are running on a Hypervisor that is QEMU based (e.g., Proxmox or Libvirt), you now have a lot more information in your Hypervisor control panel, proper shutdown support and improved support for backing up/snapshotting your virtual machine.

Finally, the automated disk expansion got some updates. So if you need more disk space in your virtual appliance, add it in your Hypervisor and HassOS automatically pick it up at the next boot.

We want to emphasize that running Hass.io as a virtual machine is the only supported method to run Hass.io on a virtualized system. We’ve lately seen some funky tutorials on how to run Hass.io inside a container like Docker or LXC, which we DO NOT recommend, you will end up having issues.

How to update to HassOS 3

If you are already running HassOS, you have the full flavor of Hass.io, and thus, all the comfort it has to offer, making this upgrade a breeze!

To update via the user interface, go to the Home Assistant frontend, click on Hass.io in the sidebar to go into the Hass.io panel. Next, click on the System tab and press the UPDATE button in the “Host system” panel. In case the update isn’t showing up yet, push the RELOAD button on the “Hass.io supervisor” box first, which makes your system look for updates instantly.

Another option is to use our powerful CLI, that is shipped with the SSH add-on. Run the following command to trigger the upgrade: hassio os update --version 3.7.

Docker

Update 2019-12-18

After some confusion about the statement of supporting virtual environments and running Hass.io on top of a custom Linux; so let’s clarify it.

The supported ways to run Hass.io are documented here: https://www.home-assistant.io/hassio/installation/

This also includes running Hass.io on Linux using the Generic Linux installer, which is a supported method.

Hass.io runs partly on your local machine, but for most parts inside multiple containers. All installation types we list, respect this.

Hassio Docker Raspberry Pi 4 Download

If you run VMWare, ProxMox or other virtualization environments, you can use the HassOS OVA/VMDK to run a virtual machine with. Or, if you like to use a Ubuntu VM, that will work with the supported generic Linux installer.

Hassio Docker Raspberry Pi 4 Specs

We DO NOT support any kind of LXC hacks like listed here: https://github.com/whiskerz007/proxmox_hassio_lxc. These setups try to put everything inside a single container, which will cause you issues. Hass.io is not designed to run fully inside a containerized system, like LXC.

Hassio Docker Raspberry Pi 4 Software

We hope this clarifies our earlier statement.