Restoring or migrating from 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 to a Home Assistant Yellow.

A full backup includes the following elements:

your system configuration
add-on data
automations
scripts
and media stored on Home Assistant.

Estimated duration

The time it takes to restore a backup depends on your installation. Home Assistant Core and all 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.
Start up Home Assistant Yellow as described in the Getting started procedure.
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