jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

backup emergency kit: remove redundant procedures (#36681)

Browse Source 
* backup emergency kit: remove redundant procedures

* Fix typo
This commit is contained in:
c0ffeeca7 2025-01-03 16:57:16 +01:00 committed by Franck Nijhof
parent ac5ccec3c3
commit 94ead7be30
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
2 changed files with 16 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
source/_includes/common-tasks/update.md
View File

@ -1,6 +1,6 @@
Best practice for updating Home Assistant Core: Best practice for updating Home Assistant Core:
1. Backup your installation{% if page.installation == "os" or page.installation == "supervised" %}, using the [backup functionality](/common-tasks/general/#backups) Home Assistant offers{% endif %}. 1. Back up your installation{% if page.installation == "os" or page.installation == "supervised" %}, using the [backup functionality](/common-tasks/general/#backups) Home Assistant offers{% endif %}.
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**.
{% if page.installation == "os" or page.installation == "supervised" %} {% if page.installation == "os" or page.installation == "supervised" %}
3. Select **Create backup before updating** in case you encounter an issue that requires a rollback. 3. Select **Create backup before updating** in case you encounter an issue that requires a rollback.

37
source/more-info/backup-emergency-kit.markdown
View File

@ -1,45 +1,38 @@
--- ---
title: "Backup emergency kit" title: "Backup emergency kit"
description: "Information about backup emergency kit" description: "Information about backup emergency kit"
related:
- docs: /common-tasks/general/#backups
title: Backups
--- ---
Backups are encrypted (using [AES-128](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard)). The backup emergency kit contains information needed to recover your backup, such as the encryption key and metadata about the backup. [Backups](/common-tasks/general/#backups) are encrypted (using [AES-128](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard)). The backup emergency kit contains information needed to recover your backup, such as the encryption key and metadata about the related backup.
## What is encryption and why are backups encrypted? ## What is encryption, and why are backups encrypted?
Encryption is a method of converting data into a coded format so that it can only be read by someone who has the decryption key. This ensures that your data about your home remains private. So even if someone else had a copy of your Home Assistant backup, it is unreadable for them without the decryption key. Encryption is a method of converting data into a coded format so that it can only be read by someone who has the encryption key. This ensures that your data about your home remains private. So even if someone else had a copy of your Home Assistant backup, it is unreadable for them without the encryption key.
## Storing the backup emergency kit somewhere safe ## Storing the backup emergency kit somewhere safe
1. To download the emergency kit, go to {% my backup title="**Settings** > **System** > **Backups**" %} 1. To download the backup emergency kit, go to {% my backup title="**Settings** > **System** > **Backups**" %}
2. If it is your first time defining backup settings, select **Setup automatic backup** and download the backup emergency kit. 2. If it is your first time defining backup settings, select **Setup automatic backup** and download the backup emergency kit.
- You can also download the encryption key again later from the configuration page. - You can also download the encryption key again later from the backup configuration page.
![Screenshot showing the encryption key in the download dialog for the backup emergency kit](/images/more-info/backup_emergency_kit_01.png) ![Screenshot showing the encryption key in the download dialog for the backup emergency kit](/images/more-info/backup_emergency_kit_01.png)
3. Store the kit somewhere safe, outside the Home Assistant system. 3. Store the kit somewhere safe, outside the Home Assistant system.
- Without the encryption key, there is no way to restore the backup. - Without the encryption key, there is no way to restore the [backup](/common-tasks/general/#backups).
## Changing your encryption key ## Changing your encryption key
When you set up your backups, an encryption key is generated automatically. This key is used for all your backups. You can replace this key with a new one, which will be used for all future backups. To decrypt backups created before the change, you will still need the previous encryption key. When you set up your [backups](/common-tasks/general/#backups), an encryption key is generated automatically. This key is used for all your backups. You can replace this key with a new one, which will be used for all future backups. To decrypt backups created before the change, you will still need the previous encryption key.
1. To generate a new encryption key, go to {% my backup title="**Settings** > **System** > **Backups**" %}.
2. Select **Configure automatic backups** and under **Encryption key**, select **Change**.
3. If you haven't downloaded the old emergency kit yet, do it now.
4. Select **Change encryption key**.
5. Download the new encryption key and store it in a safe place.
## Checking and disabling backup location
1. Go to {% my backup title="**Settings** > **System** > **Backups**" %}. 1. Go to {% my backup title="**Settings** > **System** > **Backups**" %}.
2. Select **Configure automatic backups** and under **Locations**, you can see where your backups are currently stored. 2. Select **Configure automatic backups** and under **Encryption key**, select **Change**.
3. You can also enable or disable a backup location. 3. If you haven't downloaded the old emergency kit yet, do it now.
- As the new encryption key won't work for the backups you've taken until now, keep it somewhere safe and make a note of which backups it applies to.
## Changing the local backup location 4. To generate a new encryption key, select **Change encryption key**.
5. Download the new encryption key and store it in a safe place.
1. To change the local default backup location, go to {% my backup title="**Settings** > **System** > **Backups**" %}.
2. In the top-right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select the local backup location.
## I lost my backup encryption key - how can I retrieve it? ## I lost my backup encryption key - how can I retrieve it?