About restoring a backup or migrating using a backup
There are two ways you can use a backup:
- You can use a backup to recover your existing configuration on your current system.
- You can use a backup during the onboarding process to restore your configuration. For example, if you want to migrate from another device (such a Raspberry Pi) to a Home Assistant Green or a Home Assistant Yellow.
Elements included in full backup
A full backup includes the following elements:
- your system configuration
- app data (formerly known as add-ons)
- automations
- scripts
- and media stored on Home Assistant.
Before creating a backup, you can select what to include or exclude for a backup.
Estimated duration
The time it takes to restore a backup depends on your installation. Home Assistant Core and all apps (formerly known as add-ons) are being reinstalled. For a larger installation, this process can take about 45 minutes to 1 hour.
Restoring from a backup during onboarding
- If you want to migrate your configuration from another device, make sure the prerequisites are met.
- Specifically, check the size of your current installation.
- Your installation needs to be a bit smaller than the available eMMC disk space on your new device.
- Start up the device as described in the Getting started procedure for your specific configuration.
- Follow the steps described in the Restoring a backup during onboarding procedure.
Restoring a backup on your current installation
If you want to restore your full configuration or even only parts of it, follow the steps described in the procedure on restoring a backup on your current system.
Related topics
Edit this article on GitHub