# Timeshift — System Restore and Snapshot Tool for Linux

> A system backup and restore utility that creates filesystem snapshots using rsync or Btrfs, enabling quick rollback after failed updates.

## Install

Save in your project root:

# Timeshift — System Restore and Snapshot Tool for Linux

## Quick Use
```bash
# Install
sudo apt install timeshift   # Debian/Ubuntu/Mint
sudo pacman -S timeshift      # Arch

# Create a snapshot
sudo timeshift --create --comments "Before upgrade"
# Restore
sudo timeshift --restore
```

## Introduction
Timeshift is a system restore tool for Linux maintained by Linux Mint. It creates incremental snapshots of the root filesystem using rsync with hard links or native Btrfs snapshots, letting you roll back your system to a known-good state after a failed update or configuration change.

## What Timeshift Does
- Creates scheduled or on-demand filesystem snapshots
- Supports two backends: rsync (works on any filesystem) and Btrfs native snapshots
- Restores from snapshots while the system is running or from a live USB
- Manages retention policies: keep N hourly, daily, weekly, and monthly snapshots
- Excludes user data by default to focus on system files

## Architecture Overview
Timeshift runs as a background service (crond or systemd timer) and a GTK desktop application. In rsync mode, it copies changed files to a snapshot directory using hard links for unchanged files, making each snapshot space-efficient. In Btrfs mode, it creates and manages subvolume snapshots directly through btrfs commands.

## Self-Hosting & Configuration
- Install via apt, pacman, or from the GitHub PPA
- Launch the GUI with `sudo timeshift-gtk` or use the CLI with `sudo timeshift`
- Choose between rsync and Btrfs backend during initial setup
- Configure snapshot schedule and retention in the Settings tab
- Exclude additional directories via the Filters tab or --exclude flag

## Key Features
- Incremental rsync snapshots use hard links to minimize disk usage
- Btrfs backend creates near-instant copy-on-write snapshots
- Scheduled snapshots with configurable retention levels
- Restore from the running system or a live environment
- CLI and GUI interfaces for both headless servers and desktops

## Comparison with Similar Tools
- **Snapper** — SUSE's Btrfs snapshot manager; Timeshift is simpler with rsync fallback
- **rsnapshot** — rsync-based backup tool; Timeshift adds a GUI and system restore workflow
- **BorgBackup** — deduplicated archival backup; Timeshift focuses on quick system rollback
- **Restic** — encrypted remote backup; Timeshift targets local system snapshots
- **BTRFS send/receive** — manual Btrfs operations; Timeshift automates scheduling and retention

## FAQ
**Q: Does Timeshift back up my home directory?**
A: By default, no. Timeshift focuses on system files. Use a separate tool for personal data.

**Q: Can I restore without booting the system?**
A: Yes. Boot from a live USB with Timeshift installed and restore from there.

**Q: How much disk space do snapshots use?**
A: Incremental rsync snapshots share unchanged files via hard links, so each additional snapshot is small.

**Q: Does it work on servers without a GUI?**
A: Yes. The CLI (timeshift --create, --restore) works on headless systems.

## Sources
- https://github.com/linuxmint/timeshift
- https://teejeetech.com/timeshift/

---
Source: https://tokrepo.com/en/workflows/asset-e52bf1fb
Author: AI Open Source