Fiw-Gentoo-Dots/docs/backups.md

1.4 KiB

Restore a config backup

At the final TUI preview, press u to browse user config backups. Choose a backup to see its file list, then press Enter to begin the restore prompts. Esc returns to the selection screen. An empty chooser does not apply anything.

The command-line equivalents are:

./install --list-backups
./install --backup-plan BACKUP_ID
./install --restore-backup BACKUP_ID

Run restoration as the target user. KDE backups require logging out of Plasma and running from a TTY. The backup's contents determine this requirement, independently of which presets are currently selected.

Restoration has a final confirmation and apply-or-keep prompts for existing files. Each replaced current file gets a new backup. Afterwards, updates treat the restored settings as local preferences and leave new proposals in .new files. Unchanged files are left as they are.

Backups contain files replaced during earlier config application. Files first created by that application are retained when restoring a backup. Unrelated files are also retained. Only recognized config paths inside the target home can be restored; unsafe directory links and unexpected backup paths stop the operation before writes.

User backups live under ~/.local/state/Fiw-Gentoo-Dots/backups. The TUI action restores user configs. System Portage and boot backups remain available under /var/lib/Fiw-Gentoo-Dots/backups for manual restoration.