Common Tasks - Container


Best practice for updating a Home Assistant installation:

  1. Backup your installation.
  2. Check the release notes for breaking changes on Home Assistant release notes. Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (CTRL + f / CMD + f) and search for Breaking Changes.

First start with pulling the new container.

docker pull homeassistant/home-assistant:stable

You can also use spesific containers for your hardware. Like Raspberry pi 4:

docker pull homeassistant/raspberrypi4-homeassistant:stable

You then need to recreate the container with the new image.

docker-compose pull homeassistant
docker-compose up -d

Run a specific version

In the event that a Home Assistant Core version doesn’t play well with your hardware setup, you can downgrade to a previous release. In this example 2021.5.2 is used as the target version but you can choose the version you desire to run.

ha os update --version 2021.5.2

Run a beta version

If you would like to test next release before anyone else, you can install the beta version.

ha os update --version 2021.5.2

Run a development version

If you want to stay on the bleeding-edge Home Assistant Core development branch, you can upgrade to dev.

The dev branch is likely to be unstable. Potential consequences include loss of data and instance corruption.

ha os update --version 2021.5.2

Configuration check

docker exec homeassistant python -m homeassistant --script check_config --config /config

If your container name is something other than homeassistant, change that part.