Common Tasks
Update
Best practice for updating a Home Assistant installation:
- Backup your installation.
- 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
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.2.3 is used as the target version but you can choose the version you desire to run.
ha os update --version 2021.2.3
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.2.3
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.2.3
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.
Suggest an edit to this page, or provide/view feedback for this page.