Update steps on updating to reflect the current software (#39267)

Co-authored-by: Stefan Agner <stefan@agner.ch>
This commit is contained in:
c0ffeeca7 2025-06-10 10:55:48 +02:00 committed by GitHub
parent 710aa785e3
commit ac656a70e5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 31 additions and 9 deletions

View File

@ -1,9 +1,12 @@
Best practice for updating Home Assistant Core: #### Prerequisites
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. 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. - 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**. 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. To update Home Assistant Core, choose one of the following options.
#### To update Home Assistant Core
To update Home Assistant Core, choose one of the following options.
{% if page.installation == "os" %} {% if page.installation == "os" %}
@ -20,6 +23,10 @@ Best practice for updating Home Assistant Core:
- Go to {% my updates title="**System** > **Updates**" %}. - Go to {% my updates title="**System** > **Updates**" %}.
- Select the update notification. - Select the update notification.
- Select the cogwheel {% icon "mdi:cog-outline" %}, then set **Visible** to active. - Select the cogwheel {% icon "mdi:cog-outline" %}, then set **Visible** to active.
4. Open the notification for the component you want to update.
5. If you want to backup the system first (recommended), enable the backup toggle.
6. Select **Update**.
7. After the update completed, 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.
- title: Using the CLI - title: Using the CLI
content: | content: |
@ -57,6 +64,7 @@ Best practice for updating Home Assistant Core:
{% endtabbed_block %} {% endtabbed_block %}
After the update, 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.
{% endif %} {% 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.

View File

@ -31,7 +31,9 @@ If you have the {% term "Home Assistant Operating System" %} installed, you rece
- {% term "Home Assistant Operating System" %} - {% term "Home Assistant Operating System" %}
- {% term "Home Assistant Supervisor" %} - {% term "Home Assistant Supervisor" %}
- {% term "Home Assistant Core" %} - {% term "Home Assistant Core" %}
- Add-ons, if you have any installed - {% term "Add-ons" %}, if you have any installed
Each of these components needs to be updated separately.
### Updating the Home Assistant Operating System ### Updating the Home Assistant Operating System
@ -39,8 +41,9 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
#### Prerequisites #### Prerequisites
- [Backup](/common-tasks/general/#backups) your installation. - [Backup your installation](/common-tasks/general/#backups).
- Make sure the backup is downloaded and stored outside of the system. - Make sure the backup is stored on a [backup location](/common-tasks/general/#defining-backup-locations) outside of the device where Home Assistant is installed.
- For example, if Home Assistant is installed on [Home Assistant Green](https://www.home-assistant.io/green), make sure it is stored on [Home Assistant Cloud](/common-tasks/general/#about-the-backup-storage-on-home-assistant-cloud) or another location.
- So that you can [restore from that backup](/common-tasks/general/#restoring-a-backup) in case there is an issue with the system. - So that you can [restore from that backup](/common-tasks/general/#restoring-a-backup) in case there is an issue with the system.
#### To update the Home Assistant Operating System #### To update the Home Assistant Operating System
@ -52,8 +55,15 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
1. Open the **Settings** panel. 1. Open the **Settings** panel.
2. On the top you will be presented with an update notification. 2. On the top you will be presented with an update notification.
- **Troubleshooting**: If you do not see that notification:
_If you do not see that notification, in the top right, select the three dots menu and select **Check for updates**"._ - 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.
3. Open the notification for the component you want to update.
4. If you want to update the system first (recommended), enable the backup toggle.
5. Select **Update**.
6. 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.
- title: Using the CLI - title: Using the CLI
content: | content: |
@ -66,6 +76,8 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
{% endtabbed_block %} {% endtabbed_block %}
{% details "Advanced: changing the boot slot used during the update" %}
#### About boot slots used during the update #### About boot slots used during the update
The {% term "Home Assistant Operating System" %} uses two boot slots. On first installation, boot slot A is used. After that, on each Operating System update, the other boot slot is updated and reboot is triggered. On that reboot, the system boots from the other boot slot (A ➝ B ➝ A,...). When booting fails, the system automatically uses the previous boot slot, so that it boots from the last working operating system. The {% term "Home Assistant Operating System" %} uses two boot slots. On first installation, boot slot A is used. After that, on each Operating System update, the other boot slot is updated and reboot is triggered. On that reboot, the system boots from the other boot slot (A ➝ B ➝ A,...). When booting fails, the system automatically uses the previous boot slot, so that it boots from the last working operating system.
@ -89,6 +101,8 @@ You can manually define that the previous boot slot is used. This can be useful
Alternatively, if the Operating Systems runs on a platform that uses the GRUB bootloader, a boot menu is presented early in the boot. The alternative boot slot can be selected here, marking it active for future boots if the following boot attempt is successful. Alternatively, if the Operating Systems runs on a platform that uses the GRUB bootloader, a boot menu is presented early in the boot. The alternative boot slot can be selected here, marking it active for future boots if the following boot attempt is successful.
{% enddetails %}
### Updating Home Assistant Core ### Updating Home Assistant Core
{% include common-tasks/update.md %} {% include common-tasks/update.md %}