https://bugs.kde.org/show_bug.cgi?id=523223
Bug ID: 523223
Summary: Documentation should explain how to browse and restore
files from versioned (bup) backups
Classification: Applications
Product: kup
Version First unspecified
Reported In:
Platform: Kubuntu
OS: Linux
Status: REPORTED
Severity: normal
Priority: NOR
Component: general
Assignee: [email protected]
Reporter: [email protected]
Target Milestone: ---
Documentation Improvement Proposal
Kup Backup – Accessing files stored in versioned (bup) backups
The current documentation states that files stored in a versioned backup
archive cannot be viewed directly with a file manager. However, it does not
explain why this is the case or how users can access those files afterwards.
As a result, new users may assume that their backup is incomplete because the
backup destination only contains directories such as objects, refs, logs, and
files like HEAD and config.
I would like to suggest adding information similar to the following:
Accessing files in a versioned backup archive (bup)
Files stored in a versioned backup archive cannot be viewed directly with a
file manager such as Dolphin. A versioned backup is stored as a bup repository,
which does not expose the backed-up files as a normal directory tree.
This is the expected behaviour. The backup is complete; the files are stored
internally in the repository.
If the backup destination only contains directories such as objects, refs,
logs, and files like HEAD and config, this is the normal layout of a bup
repository.
Individual files and folders can be browsed and restored with Kup File Digger
(kup-filedigger), which is included in the kup-backup package.
If the repository is not detected automatically, open the directory containing
the objects, refs, logs, HEAD, and config entries. Alternatively, the
repository can be opened from the command line:
kup-filedigger <path-to-bup-repository>
After opening the repository, available backup snapshots can be browsed and
individual files or complete directories can be restored without restoring the
entire backup.
Reason for this proposal
This proposal is based on practical testing with Kubuntu 26.04 LTS.
The backup itself works correctly. The confusion arises because users only see
the internal repository structure on the backup medium and may therefore
believe that their personal files were not backed up.
Explaining that this is the expected layout of a bup repository and pointing
users to Kup File Digger would help prevent this misunderstanding and make the
documentation clearer for new users.
--
You are receiving this mail because:
You are watching all bug changes.
