3…2…1… Backup

Home Assistant is a powerful tool that can save you time and money by automating your home. Pretty important things around the home, from heating to an automatic fish feeder, need to depend on it. However, as your setup grows more complex, maintaining it—what we call “digital housekeeping”—can become a time-consuming task. Backups are a critical part of this maintenance, yet they’re often overlooked, especially by new users, often until it is too late when disaster strikes.

To make backups effortless, we’ve introduced new automated and off-site backup features in the latest release of Home Assistant. These improvements will make it easier than ever to safeguard your setup. As we step into the New Year, we would encourage you to adopt a simple yet crucial resolution: regularly back up your data. With our new tools, it takes just five minutes to set up and provides lasting peace of mind.

Learn more about our backups below, or get started now by updating and visiting the backups page.

What’s in a backup?

Backups are essential for a reliable smart home. They protect your system from hardware failures, natural disasters, and cyberattacks, allowing you to quickly restore operations. A solid backup strategy follows the 3-2-1 rule:

  • 3 copies of your data
  • 2 stored on different media
  • 1 kept off-site

While this may seem excessive, consider a scenario like a lightning strike: both your Home Assistant system and any local storage, like network-attached storage (NAS), could be destroyed. That’s why an off-site backup is non-negotiable for true resilience, and a comprehensive backup strategy should include:

  • Regular and frequent backups of critical data
  • Following the 3-2-1 rule for redundancy
  • Encrypting backups to protect against theft and corruption
  • Testing backups to ensure they are functional
  • Defining how long backups should be retained

To support these best practices, we have worked hard to introduce Automatic Backups and seamless integration with off-site backup location providers, such as Home Assistant Cloud. These updates, part of our 2024 roadmap, make it easier than ever to provide peace of mind to our users, by implementing a robust backup strategy, and keep your smart home running smoothly.

Backups have never been this easy

Home Assistant backups are incredibly good, backing up every setting and add-on, making restores feel a bit like magic. It even works across different CPU architectures! Up until recently setting up a 3-2-1 backup strategy in Home Assistant was not entirely straightforward. This changes with Home Assistant 2025.1, where we’re elevating our backup experience with three new important features.

  • Automatic encrypted backups - You can now schedule automatic backups every night or once a week, ensuring you always have a recent backup at hand.
  • Automatic cleanup - No longer worry about backups overrunning your disk space, as you can now set the maximum number of backups that should be stored.
  • Backup locations - We have added a new system for integrations to provide backup locations (also known as backup agents), allowing you to sync backups to both local or off-site storage. It’s launching with support for network shares and Home Assistant Cloud (included at no additional cost to subscribers), with more locations to follow.

Get started with our Backup Wizard

The new automatic backup feature in Home Assistant 2025.1 comes with a new easy to use backup wizard. With a couple of clicks, you can backup your Home Assistant system on a regular schedule and easily choose the places where backups are stored. New users will be prompted with a wizard to make sure they set up automatic encrypted backups. Selecting the recommended settings ensures that a backup is made every night, that three backups are kept, and that they are uploaded to all available locations.

Backup locations

At launch, only a few backup locations will be available, but we’ve made it easy for developers to integrate more, so expect a lot of options to follow. As part of this renewed focus on smart home resilience set out in our roadmap, cloud backup has been added to Home Assistant Cloud, which will be available day one to all subscribers for no additional cost. It will only store the latest backup, which must be under 5GB (you’ll be notified to repair it if it is too large to upload). If you lose your other backups, you can always go to your Cloud account page and download the latest backup.

New Home Assistant features like this supercharged backup capability is only possible with funding from our Home Assistant Cloud subscribers. Adding backup to the subscription at no additional cost, was the least we could do to thank them for their continued support.

Secure by default

Backups contain all Home Assistant data, including all the keys to every integrated device in your smart home and the history of how you live your life. This data is very important to keep secure. With automatic backups and the 3-2-1 approach we are promoting to users to store their backups off-site. This is why all automatic backups are fully encrypted.

When a user configures automatic backups, they will be presented with the encryption key and the option to download an emergency kit. The emergency kit contains all the important information, including a link to the instructions on how to use it to restore a backup. If you were to ever delete your emergency kit, it is available to re-download in the backup configuration page.

Apply 3-2-1 to your backups

Check out the above video tutorial or read our docs to learn more about setting up automatic and off-site backups.

Conclusion

Too often, people just starting their smart home journey move forward a little too fast and make a mistake that causes some downtime. This impacts the household’s confidence, as something that should be making their lives easier is actually seen as unreliable. Avoid this early pitfall and build a resilient smart home with 3-2-1 backups.


This is a companion discussion topic for the original entry at https://www.home-assistant.io/blog/2025/01/03/3-2-1-backup
4 Likes

Oh, so today is release day

1 Like

That’s correct!

Just started playing with the new Backup Scheme.
After upgrading to this release, make sure you do a browser refresh in order to see the new wizard.

2 Likes

Great job, but addon exclusion is still missing from the partial backup at the frontend and in the actions too. :frowning:

Immediately activated on both my systems. This was really a needed feature.

This is great!

So what’s recommended to address backups that are larger than 5GB?

I’ve had mine uploading to OneDrive for some time and believe mine are currently around 13GB…

It’d be great if the individual backup details showed you not only versions, but consumption for each component and add-on.

2 Likes

not really per component but you can download the back-up, extract the archive and see the relative size of each folder, that will help point you to the big data consumers.

It’s impressive how fast Home Assistant has progressed from “this is how we have to do it” to “this is how it should be done” and equally impressive how you all keep making that leap. Excited to see what’s in store for 2025!

4 Likes

No. The backup is encrypted and the only strategy is to restore it all.

I have not tried one of the new backups ( with the stupid mandatory encryption) but with old backups you just download the tar archive on your machine extract it and see folder/file sizes. No need to restore anything.

2 Likes

Isn’t it possible anymore then to extract the backup files?
I didn’t upgrade yet, but I do this quite often too, to view my old yaml file when I want to check my old config

5 Likes

There is a python tool. Kind of hard to use. And they are looking into a possibility to make Thies easier.

“with the stupid mandatory encryption”

As someone who has been pushing for encryption in HAss backups for a long time, I disagree with the “stupid” part. Those backups have A LOT of sensitive info in them, and (especially when you have off-site backups, as you should!) encryption is essential.

True, it would be nice to have some kind of decryption utility allowing you to quickly extract just one file - but I am sure that will come along quite quickly, now that the encrypt/decrypt code is in place.

7 Likes

there is a bug in the setting wizzard.
It’s not possible to set custom amount of backups to anything else then “3”.

For now I will keep the “Samba Backup” addon. That works for me without any problems since a long time allready.

2 Likes

As someone who needs a simple easy way to extract a file from a backup I’m going to stick with the “stupid” comment for now. The reason i call it “stupid” is because mandatory encryption did not need to be there for most of the base functionality (its only really needed for nabu case backups and yes it should be mandatory there)

And while a decryption utility would be nice in the future, that is only true if all the backups were not encrypted automatically with no way to disable it, that either makes a decryption utility mandatory now or makes the option to disable encryption mandatory in my book.

I’ll restate that having automated backups and and encryption are two very good things and a great addition to the platform, however the whole discussion around the feature is now turning in a b*** fest by encryption being mandatory (and yes i realize I’m doing that too)

9 Likes

I do agree with you that there should be an option to disable the default encryption if you really want to. I am always a fan of people having options. And I do hope that the developers will add such an option in the future (with heavy warnings and “are you REALLY sure you know what you’re doing?!” confirmations, but… the option should be there).

However, once again I will disagree on the second part - it’s not needed “only” for nabu casa backups. It is needed every single time you replicate backups off-site, and many times even for local backups, if there are other people/apps that can access the backup location. Security by default is never a “stupid” idea (funny story - even the people at Elastic/ElasticSearch learned this the hard way :slight_smile: )

[ Edited to add a link to another topic where I was actually requesting this feature of encrypted backups :slight_smile: ]

7 Likes

I’m running HA as docker container.
I just set up an initial backup schedule, but it seems the only storage location is “This system” (i.e. local backup only), which results in a tar file below the HA config directory.
This is kind of useless for me, since I already backup the config directory separately.
Reading the announcement I assumed that I could at least specify a network location (e.g. samba share).
But there does not seem to be an “add location” button anywhere?

2 Likes

If encrypted backup is a very good idea, force encryption without decryption tool is very stupid !

  • What’s in the backup : I do not know :frowning:
  • How extract just one file ? It is not possible :frowning:
  • How verity the content of a backup : It is not possible :frowning:

Without decryption tool or the choice to not encrypt backups, i’ll not upgrade to this version !

7 Likes