btrfs-restore

Restore all files from a btrfs device

$ sudo btrfs restore [path/to/btrfs_device] [path/to/target_directory]

$ sudo btrfs restore -D [path/to/btrfs_device] [path/to/target_directory]

$ sudo btrfs restore --path-regex [regex] -c [path/to/btrfs_device] [path/to/target_directory]

$ sudo btrfs restore -t [bytenr] [path/to/btrfs_device] [path/to/target_directory]

$ sudo btrfs restore -m -x -S -o [path/to/btrfs_device] [path/to/target_directory]

btrfs restore [options] device target

btrfs restore attempts to salvage files from a damaged btrfs filesystem that cannot be mounted normally. It reads filesystem structures directly from the device and copies recoverable files to a target directory.
This is a data recovery tool for when other methods fail. It does not repair the filesystem; it extracts data to a healthy location.

-D, --dry-run

List files without extracting

Only restore files matching pattern

Case-insensitive regex matching

Use specific root tree (see btrfs-find-root)

Restore metadata (permissions, times)

Restore extended attributes

Restore symbolic links

Overwrite existing files in target

Verbose output

Does not fix the filesystem; only extracts data. May not recover all files from severely damaged filesystems. Regex must match full path including parent directories. Target directory should be on a different filesystem.

btrfs(8), btrfs-rescue(8), btrfs-check(8)