Correction needed in “Restoring a Backup” section

[diegomontanaduarte]

Feedback

While attempting to restore my Home Assistant container from a backup, I encountered an issue with the command provided in the “Restoring a Backup” section.

The command in the documentation is as follows:

tar -xOf <backup_tar_file> "./homeassistant.tar.gz" | tar --strip-components=1 -zxf - -C <restore_directory>

When executed, this command fails with the following error:

tar: ./homeassistant.tar.gz: Not found in archive
tar: Exiting with failure status due to previous errors
gzip: stdin: unexpected end of file
tar: Child returned status 1
tar: Error is not recoverable: exiting now

Upon inspecting the contents of the backup tar file using tar -tf, I noticed that homeassistant.tar.gz is listed without the ./ prefix. This discrepancy causes the extraction command to fail.

To resolve the issue, I suggest updating the command in the documentation to the following:

tar -xOf <backup_tar_file> "homeassistant.tar.gz" | tar --strip-components=1 -zxf - -C <restore_directory>

This corrected command properly handles the file path as listed in the archive and allows the restoration process to complete successfully.

URL

https://www.home-assistant.io/integrations/backup/

Version

2024.11.2

Additional information

No response

[home-assistant]

Hey there @home-assistant/core, mind taking a look at this feedback as it has been labeled with an integration (backup) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of backup can trigger bot actions by commenting:

• @home-assistant close Closes the feedback.
• @home-assistant rename Awesome new title Renames the feedback.
• @home-assistant reopen Reopen the feedback.
• @home-assistant unassign backup Removes the current integration label and assignees on the feedback, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information) to the feedback.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information) on the feedback.