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 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Restore from backup during onboarding - update steps (#38695)

Browse Source
This commit is contained in:
c0ffeeca7 2025-04-23 15:14:14 +02:00 committed by GitHub
parent 093cdba930
commit aef44d931a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 17 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
source/_includes/common-tasks/backups.md
View File

@ -190,17 +190,24 @@ You can use a backup during the onboarding process to restore your configuration
1. If you are migrating to a new device and you had controllers or radios connected (such as a Z-Wave stick or Connect ZBT-1):
- make sure to plug them into the new device.
2. After Home Assistant has been installed, on the welcome screen, select **Restore from backup**.
- Then, select **Upload backup**.
- The file explorer opens on the device on which you are viewing the Home Assistant User interface.
- You can access any connected network drive from there.
3. Select the backup file, then, in the dialog, select all parts you want to restore.
- Your current system will be overwritten with the parts that you choose to restore.
- If you want to restore the complete configuration with all directories and add-ons, select everything.
4. Under **Backup password**, enter the encryption key stored in the [backup emergency kit](/more-info/backup-emergency-kit/).
5. To start the process, select **Restore**.
2. You can either restore a backup from your local machine or a backup stored on Home Assistant Cloud:
- **Option 1**: restoring from a local backup.
- On the welcome screen, select **Upload backup**.
- Select **Select backup file**.
- The file explorer opens on the device on which you are viewing the Home Assistant User interface.
- You can access any connected network drive from there.
- Select the backup file.
- **Option 2**: restoring from a Home Assistant Cloud backup.
- On the welcome screen, select **Home Assistant Cloud**.
- Sign in to Home Assistant Cloud.
3. In the dialog, select all the parts you want to restore.
- Your current system will be overwritten with the parts that you choose to restore.
- If you want to restore the complete configuration with all directories and add-ons, select everything.
4. Enter the encryption key stored in the [backup emergency kit](/more-info/backup-emergency-kit/).
5. To start the process, select **Restore backup**.
- The restore may take a while, depending on the amount of data.
- To see if the restore is complete, reload the page from time to time.
- Don't refresh the page. Just wait.
- If you refresh the page, you will see a "Not found" message. This is because the system is shutdown, wiped, and reinstalled from the backup. During that time, it won't be reachable.
- If your previous installation had certificates enabled directly for the [`http` integration](/integrations/http), when the restore is complete, it will no longer respond to `http://` requests. In this case, use `https://` (added `s`) instead.
6. On the login screen, enter the credentials of the system from which you took the backup.
- The login password and username must match the ones you used at the time the backup was taken.