Home

Konserve Documentation

This wiki provides technical documentation and usage guides for Konserve, a Rust-based backup and restore tool with a GUI built using eframe.

Konserve creates portable .tar archives of selected folders and files and supports full or partial restoration on any Windows system.

---

Table of Contents

• Using Konserve
• Settings
• Templates
• Backup Format
• Restoration Logic
• Developer Setup
• Troubleshooting
• Changelog
• Roadmap

---

Quick Overview

• Select files/folders using the GUI
• Backups are saved as .tar archives with UUID mapping
• fingerprint.txt maps original paths to UUIDs inside each archive
• Restores support partial selection using a collapsible folder tree
• Conflict resolution — choose how to handle existing files on restore (Prompt, Overwrite, Skip, Rename)
• App conflict detection — Konserve detects apps that may lock files and offers to close them before backing up
• Templates can be saved, loaded, and edited for recurring backups
• Verbose logging writes debug output to konserve.log when enabled
• Crash logging writes errors and panics to konserve-crash.log next to the exe (always active)

---

Refer to the pages above for in-depth documentation.