mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-28 13:06:48 +00:00
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
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.
|
|
|
|
{% if page.installation == "os" or page.installation == "supervised" %}
|
|
|
|
To update Home Assistant Core when you run Home Assistant {{ page.installation_name }} you have 2 options.
|
|
|
|
{% tabbed_block %}
|
|
|
|
- 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.
|
|
|
|
- title: Using the CLI
|
|
content: |
|
|
|
|
```bash
|
|
ha core update --backup
|
|
```
|
|
|
|
_The_ `--backup` _flag here ensures that you have a partial backup of your current setup incase you need to downgrade._
|
|
|
|
{% endtabbed_block %}
|
|
|
|
{% elsif page.installation == "container" %}
|
|
|
|
{% tabbed_block %}
|
|
|
|
- title: Docker CLI
|
|
content: |
|
|
|
|
**First start with pulling the new container.**
|
|
|
|
```bash
|
|
docker pull {{ site.installation.container }}:stable
|
|
```
|
|
|
|
**[You then need to recreate the container with the new image.](/installation/linux#install-home-assistant-container)**
|
|
|
|
- title: Docker Compose
|
|
content: |
|
|
|
|
```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.
|
|
|
|
{% endif %}
|