home-assistant[bot]
commented
6 days ago 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!
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