How to upgrade? raspberrypi4-homeassistant is stuck at version 2023.7.0

Published by Oliver on

If you are using the raspberrypi4-homeassistant Docker images you might have noticed that no newer versions are added anymore. Here is why that is happening and how you can easily still upgrade to the latest version.

Docker image sources for Home Assistant

There are a couple of different ways to installing Home Assistant, like a native installation, the full Home Assistant Operating System and the way I am using: Docker containers. On my smart home server running on a Raspberry Pi 4 I decided to use the most flexible yet simple solution and go with docker-compose.

Please consider supporting the blog by buying your hardware via these affiliate links if you like the content:
Raspberry Pi 4 8GB
Rapberry Pi 3B+
USB power supply for Pi 4

You can always find my newest setup over at Github. In that setup I have always used image: homeassistant/raspberrypi4-homeassistant to run my Home Assistant server. Recently I wanted to upgrade again but noticed that these images seem to be stuck at the July 2023 version.

Why there are no newer images of the raspberrypi4-homeassistant

The reason for this can be found, also a bit hidden, in the release notes for the same July 2023 version. Just have a look at the breaking changes.

Here the Home Assistant team writes that those images were “internal, intermediate, platform build image” not supposed to be widely used. I am not sure why these were published (and even recommended in many places on the Internet, which is how I found them) but now there is a better solution.

Which Home Assistant images should you use on a Raspberry Pi?

Instead of using the former specific images the generic official ones now all support multiple platforms including the Pi(s). If you want to stick with homeassistant/home-assistant:stable. Instead you can also use the recommended official images at Github:

Of course these will also support the usual versions. In my case the switch was super easy by updating the smarthome.yml file like this:

-    image: homeassistant/raspberrypi4-homeassistant:2023.5.4
+    image:

This will jump from the May version to a September version of Home Assistant and works flawlessly. No additional work is needed, no data lost.

I hope this will help you quickly updating if you run into the same issue!

Categories: HomeAssistantSoftware