DistroClone Backup & Restore

Incremental rootfs backup and restore for Debian-based systems. Companion tool to DistroClone — keeps your system safe between ISO builds.

v1.4.1 GPL-3.0 Debian · Ubuntu · Mint · LMDE yad · rsync · btrfs 6 Languages

What is DistroClone Backup?

DistroClone Backup & Restore is a graphical tool for Debian-based GNU/Linux systems that creates a full or incremental cache of the running rootfs using rsync. The cache can be restored at any time, rolling the system back to a known-good state — while keeping /home, /root and /boot/efi safe.

Designed as the companion to DistroClone (the live ISO builder), it fills the gap between full ISO snapshots by providing lightweight, scheduled, incremental protection for your daily workflow. A btrfs backend enables versioned snapshots with configurable retention.

📦 Package: distroclone-backup  |  👤 Maintainer: Franco Conidi aka edmond  |  📧 fconidi@gmail.com

Features

💾

Full Backup

Clone the entire running filesystem via rsync in one click. Creates the base cache used by incremental runs.

⚡

Incremental Backup

Only modified files are transferred, keeping subsequent backups fast and storage-efficient.

🔄

Safe System Restore

Rolls back system files from cache. /home, /root and /boot/efi are always protected and never overwritten.

🗓️

Cron Scheduler

Schedule automatic incremental backups — daily, weekly, or monthly — directly from the GUI. No manual crontab editing.

📸

Btrfs Snapshots

When the cache lives on a btrfs filesystem, versioned snapshots are created automatically with configurable max retention.

🔔

Desktop Notifications

Optional notify-send alerts when a scheduled backup completes, so you always know the last run status.

📁

Configurable Cache Dir

Store the cache on any path: internal partition, external USB drive, NFS mount. The subfolder .rootfs_cache is created automatically.

🏠

/home Inclusion Option

Optionally include /home in the backup scope. A clear warning advises that this increases backup size and time.

📋

Real-time Log

Every operation is logged to /var/log/distroclone-backup.log and shown live in a YAD log window.

🌍

Multilanguage

Auto-detects system locale. Full support for English, Italiano, Deutsch, Français, Español.

🖼️

YAD Graphical Interface

Clean GTK-based UI powered by YAD. System info (distro, kernel, cache status, cron status) shown on the main dashboard.

🤝

DistroClone Integration

Works alongside DistroClone: back up before building an ISO, restore if the build leaves the system in an inconsistent state.

Installation & First Run

1

Download the .deb package

Grab the latest release from the GitHub releases page or from syslinuxos.com. You need a Debian-based system (Debian, Ubuntu, Mint, LMDE …).

# Download with wget (adjust version number as needed)
wget https://github.com/fconidi/distroClone-backup/releases/download/v1.4.1/distroclone-backup_1.4.1_all.deb
2

Install the package

Use dpkg to install, then fix any missing dependencies automatically with apt install -f.

sudo dpkg -i distroclone-backup_1.4.1_all.deb
sudo apt install -f
✅ The package installs yad, rsync, pkexec and cron automatically. The program asks for the administrator password through polkit; no passwordless sudo rules are installed. Install btrfs-progs separately if you want snapshot support.
3

(Optional) Install btrfs-progs for snapshot versioning

If your cache destination is a btrfs partition, install the btrfs tools to enable versioned snapshot support.

sudo apt install btrfs-progs
4

Launch DistroClone Backup

Find DistroClone Backup in your application menu (System category) or launch it from the terminal.

distroClone-backup

The main dashboard opens, showing your distro, kernel, current cache status, and cron schedule.

5

(Optional) Configure the cache directory

Open Settings from the toolbar to change the cache location. Default is /mnt. Point it to an external drive or NFS share for offsite protection.

⚠️ Make sure the destination has enough free space. A typical Debian desktop rootfs is 5–15 GB.
6

Run a Full Backup

Click Full Backup. This clones the entire rootfs via rsync into <cache-dir>/<distro>_live/.rootfs_cache. Required before incremental backups can be used.

# A full backup runs in the background; progress is shown in the log window.
# Typical time: 5–20 min depending on system size.
7

Schedule automatic incremental backups

Click Schedule Backup, choose frequency (daily / weekly / monthly), the hour, and whether to show a desktop notification. Save — the crontab entry is written automatically.

# To run incremental backup silently (used by cron internally):
distroClone-backup --incremental-silent
8

Restore the system if needed

Click Restore System. A confirmation dialog shows backup date, distro, kernel, and size. Confirm, and rsync overwrites system files while protecting /home, /root, and /boot/efi. Reboot when done.

✅ Btrfs users: click Restore from Snapshot to pick any previously versioned state from the list.

CLI Usage

# Open the graphical interface
distroClone-backup

# Run a silent incremental backup (for cron jobs)
distroClone-backup --incremental-silent

Log file

tail -f /var/log/distroclone-backup.log

Supported languages

The interface language is auto-detected from the $LANG environment variable.

English
Italiano
Deutsch
Français
Español
Русский

Supported distributions

  • 🐧 Debian (Bookworm+)
  • 🟠 Ubuntu (22.04+)
  • 🌿 Linux Mint
  • 🍃 LMDE
  • 🔮 Elementary OS
  • 🖥️ SysLinuxOS
  • 🟣 ZorinOS 18
  • ➕ Other Debian derivatives

Dependencies

Package Role Status
yad Graphical dialog toolkit (GTK) Required
rsync Filesystem synchronisation engine Required
pkexec (polkit) Administrator rights for the interface Required
cron, util-linux Scheduled backups, locking and mount detection Required
distroclone Companion ISO builder Recommended
btrfs-progs Btrfs snapshot versioning support Recommended
All Required packages are installed automatically by the .deb package via apt install -f.