Update: remove Core- and Supervised-specific steps (#39221)

This commit is contained in:
c0ffeeca7 2025-05-26 13:15:09 +02:00 committed by GitHub
parent 9f7f68fa8b
commit 10b8d870bc
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -3,16 +3,13 @@ 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. 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. Update Home Assistant. 3. To update Home Assistant Core, choose one of the following options.
4. Review persistent notifications and log to see if there are any issues with your configuration that need to be addressed.
{% 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
- title: Using the UI
content: | content: |
1. Open your Home Assistant UI. 1. Open your Home Assistant UI.
@ -24,22 +21,22 @@ To update Home Assistant Core when you run Home Assistant {{ page.installation_n
- 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.
- title: Using the CLI - title: Using the CLI
content: | content: |
```bash ```bash
ha core update --backup ha core update --backup
``` ```
_The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._ _The_ `--backup` _flag here ensures that you have a partial backup of your current setup in case you need to downgrade._
{% endtabbed_block %} {% endtabbed_block %}
{% elsif page.installation == "container" %} {% elsif page.installation == "container" %}
{% tabbed_block %} {% tabbed_block %}
- title: Docker CLI - title: Docker CLI
content: | content: |
**First start with pulling the new container.** **First start with pulling the new container.**
@ -50,7 +47,7 @@ To update Home Assistant Core when you run Home Assistant {{ page.installation_n
**[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 - title: Docker Compose
content: | content: |
```bash ```bash
@ -58,30 +55,8 @@ To update Home Assistant Core when you run Home Assistant {{ page.installation_n
docker compose up -d docker compose up -d
``` ```
{% endtabbed_block %} {% 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.
{% 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.