From 10b8d870bc48a45fb3be19728c07e4fe92c32ff1 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 26 May 2025 13:15:09 +0200 Subject: [PATCH] Update: remove Core- and Supervised-specific steps (#39221) --- source/_includes/common-tasks/update.md | 99 +++++++++---------------- 1 file changed, 37 insertions(+), 62 deletions(-) diff --git a/source/_includes/common-tasks/update.md b/source/_includes/common-tasks/update.md index cdff945c3c8..19c6f7cc2dc 100644 --- a/source/_includes/common-tasks/update.md +++ b/source/_includes/common-tasks/update.md @@ -3,85 +3,60 @@ Best practice for updating Home Assistant Core: 1. [Back up your installation](/common-tasks/general/#backups) and store the backup and the [backup emergency kit](/more-info/backup-emergency-kit/) somewhere safe. - This ensures that you can [restore your installation from backup](/common-tasks/general/#restoring-a-backup) if needed. 2. Check the release notes for backward-incompatible changes on [Home Assistant release notes](/blog/categories/core/). 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 **Backward-incompatible changes**. -3. Update Home Assistant. -4. Review persistent notifications and log to see if there are any issues with your configuration that need to be addressed. +3. To update Home Assistant Core, choose one of the following options. -{% if page.installation == "os" or page.installation == "supervised" %} +{% if page.installation == "os" %} -To update Home Assistant Core when you run Home Assistant {{ page.installation_name }} you have 2 options. + {% tabbed_block %} -{% tabbed_block %} + - title: Using the UI + content: | -- 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. + - **Troubleshooting**: If you do not see that notification: + - In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Check for updates**. + - Go to {% my updates title="**System** > **Updates**" %}. + - Select the update notification. + - Select the cogwheel {% icon "mdi:cog-outline" %}, then set **Visible** to active. - 1. Open your Home Assistant UI. - 2. Navigate to the **Settings** panel. - 3. On the top you will be presented with an update notification. - - **Troubleshooting**: If you do not see that notification: - - In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Check for updates**. - - Go to {% my updates title="**System** > **Updates**" %}. - - Select the update notification. - - Select the cogwheel {% icon "mdi:cog-outline" %}, then set **Visible** to active. + - title: Using the CLI + content: | -- title: Using the CLI - content: | + ```bash + ha core update --backup + ``` - ```bash - ha core update --backup - ``` + _The_ `--backup` _flag here ensures that you have a partial backup of your current setup in case you need to downgrade._ - _The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._ - -{% endtabbed_block %} + {% endtabbed_block %} {% elsif page.installation == "container" %} -{% tabbed_block %} + {% tabbed_block %} -- title: Docker CLI - content: | + - title: Docker CLI + content: | - **First start with pulling the new container.** + **First start with pulling the new container.** - ```bash - docker pull {{ site.installation.container }}:stable - ``` + ```bash + docker pull {{ site.installation.container }}:stable + ``` - **[You then need to recreate the container with the new image.](/installation/linux#install-home-assistant-container)** + **[You then need to recreate the container with the new image.](/installation/linux#install-home-assistant-container)** -- title: Docker Compose - content: | + - title: Docker Compose + content: | - ```bash - docker compose pull homeassistant - docker compose up -d - ``` + ```bash + 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 - - ```bash - sudo -u homeassistant -H -s - ``` - -3. Activate the virtual environment that Home Assistant is running in - - ```bash - source /srv/homeassistant/bin/activate - ``` - -4. Download and install the new version - - ```bash - pip3 install --upgrade homeassistant - ``` - -5. When that is complete start the service again for it to use the new files. + {% endtabbed_block %} {% endif %} + +4. Check if there are any repair issues and check the logs to see if there are any issues with your configuration that need to be addressed.