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,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.