Recommendation for MacOS app to unzip encrypted HA backups

Does anyone know of a MacOS app that will unzip an HA encrypted backup?


tl;dr
I use HA container and nearly everything that can be defined in yaml, is.

If I made a mistake I used to simply extract the offending .yaml file from a copy on my Mac and copy it back to my Pi.

Now that backups are encrypted, I can’t do that (with the stock Mac archive app).

I guess HA still use tar and zip to make backups.
This is two standard Linux commands and since MacOS is built on a Linux code bade, then I would guess these commands are also available in MacOS.
You might have to start the terminal to access them though, but try that and then tupebtar and hit enter and also zip or unzip and hit enter.

I can unzip the .tar into its .json and .tar.gz files.

However the .tar.gz file is reported as an “Unrecognised archive format”.

also, how does one restore? I cannot see any documentation on it.

There is no app currently. You may use this website Decrypt Home Assistant backups or this python script: GitHub - sabeechen/decrypt-ha-backup: Decrypts password protected Home Assistant Backups

1 Like

In HA click on the backup you want to restore, select what to restore and click “Restore”

Try to type gzip instead of just zip.

Screenshot 2025-01-08 at 11.06.42

I cannot see a restore option (only download and delete).

same problem:
HA Core 2025.1.0/homeassistant.tar.gz: not in gzip format

My workaround is to continue to use the - action: backup.create in an automation which is still unencrypted.

Click on the name of the backup you want to restore in order to get details about this backup

1 Like

It seems we have three backup types now.

Automatic
Manual
Created by action/service call

Does anyone know if the three backup types are interchangeable? The new automatic backups are supposed to be more portable between the different types of installations per the announcement.

Can you restore all three backup types from the UI?

I would test this, but I don’t want to upgrade my instance yet.

At least they have the same option for restore (settings and/or history).
Have not yet tried to do a restore.

PS: HA in docker container.

Thanks, but I did - see my screenshot. …no restore option.

Click on the name of a backup.

1 Like

They are all interchangeable, but only the automatic and manual methods are encrypted and can be uploaded to Nabu Casa etc.

No clue how to restore the encrypted ones though as you appear to need HA to decrypt and my (container) instance appears to have no option to do it.

got it! thanks! …I was clicking on the burger at the RHS of the backup (which to me is the logical place to have it).

so, clicking on the filename seems to show a restore option for all 3 types (auto, manual, service call).


edit: I’ve created a feature request here for either the ability to decrypt outside of HA or to choose the restore location.

1 Like

This is a community guide where we are collecting alternatives to the HA Automated backups if people want to use them.

1 Like