How to restore a snapshot

Tags: #<Tag:0x00007f3264c824c0>

This guide has been updated to use the much easier method introduced in version 0.116, if you are running an older version of Home Assistant than this you can check the edit history of this post for the old instructions.

Note: this guide assumes you have copied the snapshot off your home assistant server before the problem occurred. So snapshot regularly and copy the snapshot eleswhere regularly. There are addons to do this automatically for you, here are a few:

To a NAS: Samba Backup: Create and store snapshots on a Samba share

To Goggle Drive: Add-on: Home Assistant Google Drive Backup

To DropBox: Add-on: Upload hassio snapshots to Dropbox

To NextCloud or S3: [New Addon] Snap-Shipper - Webdav and S3 backups (and probably other ways to later on)

If you have not done this, all is not lost. You may be able to recover the snapshot but it is beyond the scope of this guide.

1) Fix the issue that caused the crash.

There is little point restoring if it is just going to happen again.

For hardware this may be easy, e.g. replace a pi power supply or SD card.

For configuration issues, if you know what caused the crash you can make a copy of your snapshot and extract the relevant file using winrar, 7zip or some other compression software that allows decompressing .tar files. Edit the file and return it to the correct place in the snapshot. If you’ve done something incorrectly you still have the original snapshot to try again. Never edit this, only edit a copy. Alternatively, restore a snapshot that is older than when the issue was introduced.

2) Flash a fresh copy of home assistant to an SD card, or install using your preferred method

If it has been a while since you have done this the install instructions are here: alternative installation instructions are available in this community guide category.

3) Boot up home assistant, browse for your snapshot from the login page and restore

After a bit of time and a restart you should now have home assittant looking exactly like it did when the snapshot was taken.

Common issues:

The home assistant database or MariaDB database sometimes does not restore correctly. You can chose to repair this (search the forum for instructions) or delete it and start fresh. Home Assistant now has the ability to archive the database and create a new one on start up for the default database if corruption is detected but it does not always work as intended.

If you password protect your snapshot there is no easy way to recover individual files from it without first restoring the whole thing.


Great instructions @tom_l !

Can I just add another option for backups which I use which is the backup to DropBox:

A great addition. Go for it.

Edit: I had some other minor changes to make so I have also added the DropBox backup link.

1 Like

Since installation of 0.116.0 I got a lot of issues (mainly recorder) in the logs, decided to wait for an update, solutions seemed to be work in progress…
However after restarting my home-assistant install it was not reachable anymore. I could not get it to work again, so started with fresh install using whiskerz proxmox instruction, that worked fine.

Now let’s use the upload snapshot function… that results in:

(I get that message in Chrome, the new Edge does not report any issue).


How to proceed…?? I’ve tried restoring 116.0 and 115.x snapshots

edit: using 549mb sized snapshots

Next step I tried, completing the install of HA and Samba, copy back the backup. Then It complained:
[supervisor.snapshots.snapshot] Can't read snapshot tarfile /data/backup/e0ddd720.tar: "filename './snapshot.json' not found". It did execute the restore succesfully though.

12-10: I’ve checked the tar file, there is a snapshot.json in it and readable.

For anyone else with this issue it should be fixed soon:


Can you post links to either/both of these procedures?
The best result to my searches is this thread…lol.

I have an sql error (searched that as well) that keeps reoccurring in my logs ever since I enabled the notification sensor in the android app. I don’t use MariaDB for historical purposes (use influxdb for that) so I would like to attempt a repair and if that fails just a fresh start. Any pointers would be appreciated.

1 Like

Thanks @tom_l
Sorry for not being clear in my initial reply. I’m not using the default db but MariaDB.
I found the solution in a github issue:

Switching the db url as follows resolved my issue.

db_url: mysql://db_user:[email protected]/homeassistant?charset= utf8mb4

Where do I put the snapshot file in order to locate it upon booting the new install?

Anywhere you can browse to on or from the machine you are using to connect to home assistant.

I never get that restoring from snapshot page after the dialog box closes when I hit restore. Then when I try going to the page again I get a “empty reply” from HA.


Attempting to restore a snapshot from HA on ubuntu to Pi4. Every time I attempt to restore the snapshot the notice “Fetch Failed” comes up. I have done this several times. separate Pi’s and separate sd cards. Does anyone have any ideas?

I am seeing the same issue here trying to restore on a Pi4.

Hi Tom, the snap-shipper add-on now also supports S3 storage.