home-assistant.io/source/_includes/common-tasks/update.md

Update

Best practice for updating a Home Assistant installation:

1. Backup your installation{% if page.installation == "os" or page.installation == "supervised" %}, using the backup functionality Home Assistant offers{% endif %}.
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. {% if page.installation == "os" or page.installation == "supervised" %}
3. Select "Create backup before updating" in case you encounter an issue that requires a rollback.
4. Update Home Assistant.
5. Review persistent notifications and log to see if there are any issues with your configuration that need to be addressed. {% endif %}

{% if page.installation == "os" or page.installation == "supervised" %}

To update Home Assistant Core when you run Home Assistant {{ page.installation_name }} you have 2 options.

{% tabbed_block %}

• title: Using the UI content: |

  1. Open your Home Assistant UI
  2. Navigate to the Settings panel
  3. On the top you will be presented with an update notification

  If you do not see that notification you can click the overflow menu in the top right and select "Check for updates".

• title: Using the CLI content: |

  ha core update --backup
  

  The --backup flag here ensures that you have a partial backup of your current setup incase you need to downgrade.

{% endtabbed_block %}

{% elsif page.installation == "container" %}

{% tabbed_block %}

• title: Docker CLI content: |

  First start with pulling the new container.

  docker pull {{ site.installation.container }}:stable
  

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

• title: Docker Compose content: |

  docker-compose pull homeassistant
  docker-compose up -d
  

{% endtabbed_block %}

{% elsif page.installation == "core" %}

1. Stop the Home Assistant service.

2. Switch to the user that is running Home Assistant

   sudo -u homeassistant -H -s
   

3. Activate the virtual environment that Home Assistant is running in

   source /srv/homeassistant/bin/activate
   

4. Download and install the new version

   pip3 install --upgrade homeassistant
   

5. When that is complete start the service again for it to use the new files.

{% endif %}