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.
- 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. 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" %}
@ -20,6 +23,10 @@ Best practice for updating Home Assistant Core:
- Go to {% my updates title="**System** > **Updates**" %}.
- Select the update notification.
- 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
content: |
@ -57,6 +64,7 @@ Best practice for updating Home Assistant Core:
{% 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 %}
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 Supervisor" %}
- {% 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
@ -39,8 +41,9 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
#### Prerequisites
- [Backup](/common-tasks/general/#backups) your installation.
- Make sure the backup is downloaded and stored outside of the system.
- [Backup your installation](/common-tasks/general/#backups).
- 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.
#### To update the Home Assistant Operating System
@ -52,9 +55,16 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
1. Open the **Settings** panel.
2. On the top you will be presented with an update notification.
_If you do not see that notification, in the top right, select the three dots menu and select **Check for updates**"._
- **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.
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
content: |
@ -66,6 +76,8 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
{% endtabbed_block %}
{% details "Advanced: changing the boot slot 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.
@ -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.
{% enddetails %}
### Updating Home Assistant Core
{% include common-tasks/update.md %}