mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
Update steps on updating to reflect the current software (#39267)
Co-authored-by: Stefan Agner <stefan@agner.ch>
This commit is contained in:
parent
710aa785e3
commit
ac656a70e5
@ -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.
|
||||
|
@ -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 %}
|
||||
|
Loading…
x
Reference in New Issue
Block a user