#snapshot #zfs #recover #tool #cli-tool #file #restore

app zfs-undelete

an easy-to-use CLI tool to recover files from zfs snapshots

3 unstable releases

0.1.0 Nov 17, 2022
0.0.3 Nov 17, 2022
0.0.2 Nov 11, 2022
0.0.1 Nov 11, 2022

#1500 in Filesystem


406 lines


an easy-to-use cli tool to recover files from zfs snapshots


Use zfs-undelete <file-to-restore>. Works for file and folders.


$ pwd
$ ls
screen.png  screen01.png  screen02.png
$ rm screen01.png
$ ls 
screen.png  screen02.png
$ zfs-undelete screen01.png
found file here:
Restore file? [y/N] y
$ ls 
screen.png  screen01.png  screen02.png


with cargo:

$ cargo install zfs-undelete

from source:

$ git clone https://github.com/arctic-penguin/zfs-undelete
$ cd zfs-undelete
$ cargo install --path .


Requires the findmnt binary, which should be available on most systems.

How does it work?

If the provided file path is located under a zfs dataset, zfs-undelete searches all snapshots of the dataset in reverse alphabetical order for the file. It will restore the first file it finds.

Reverse alphabetical order is equivalent to reverse chronological order (newest first) for snapshots from most auto-snapshot tools.


~12K SLoC