Fresh install New 2025.1 Backup Feature Restore Failure (401 Error)

Hello everyone,

I’m encountering a failure while attempting to restore from an automatic generated backup from Home Assistant OS 14.2 (using the 2025.1 backup system) on a Raspberry Pi 4.

Steps to Reproduce:

  • Flashed a fresh Home Assistant OS 14.2 image onto a Raspberry Pi 4 using Raspberry Pi Imager.
  • Booted the device and proceeded through the initial onboarding process.
  • Selected “Restore from backup” and uploaded the .tar backup file generated yesterday on this same machine.
  • Selected restore options (tried full, add-ons only, and default) and entered the correct encryption key.
  • Acknowledged the “Restore partial backup” warning.
  • Immediately received a “Failed to start restore. Unknown error” dialog.

Observations:

  • The backup file was generated on the same Raspberry Pi 4 I am attempting to restore to.
  • The encryption key is verified as correct.
  • Developer tools in the browser console show a 401 Unauthorized error when the “Restore” button is clicked.

Troubleshooting Steps Taken:

  • Tried restoring with various restore options (full, add-ons, default).
  • Flashed the Pi again
  • Tried a new SD card
  • Confirmed the encryption key is accurate.

I suspect the 401 error might be the root cause of the restore failure. Has anyone else experienced this issue with the 2025.1 backup system? Any insights on how to troubleshoot this 401 error or resolve the “Unknown error” would be greatly appreciated.
Thank you for your time and assistance.

I’m facing exactly the same issue with a Raspberry Pi 3.

It’s also reported on github: Unable to restore backup with 2025.2.3 "Failed to start restore. Unknown error." · Issue #138511 · home-assistant/core · GitHub
with this potential workaround.

This does work! Thank you! Here are the steps I took to get it working:

“I’ve got the message “Failed to start restore. Unknown error.
The only way to restore from my back-up file was get in to HA as a new user/home, load my back-up file to “Settings → System → Backups” and restore it from there”