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

1. If you want to migrate your configuration from another device, make sure the prerequisites are met. Specifically, check the size of your current installation. Home Assistant Green has 32 GB of disk space, so your installation needs to be a bit smaller than that.
2. Start up Home Assistant Green as described in the getting started procedure.
3. 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

• Restoring a backup during onboarding
• Restoring a backup on your current system
• Creating a backup from the Home Assistant user interface.