ZFS Cheat Sheet

Replace disk

zfs offline <PoolName> <DiskName>
# New HDD insert
zfs replace <PoolName> <DiskName>

Snapshots

• create snapshot: zfs snapshot <POOL>@<SNAPSHOT_NAME>
• List snapshots: zfs list -t snapshot
• delete snapshot: zfs destroy <POOL>@<SNAPSHOT_NAME>
• delete multiple snapshots:

  # Be very careful!
  zfs list -H -t snapshot -o name -S creation -r > snapshots.txt
  # Remove snapshots to keep from file
  cat snapshots.txt | xargs -n 1 sudo zfs destroy
  rm snapshots.txt
  

• delete oldest 10 snapshots: zfs list -H -t snapshot -o name -S creation -r <POOL> | tail -10 | xargs -n 1 sudo zfs destroy

Status

• Basic status: zpool status
• Status with GUUIDs: zpool status -g
• Show storage usage: zfs list

Setup

• Import existing ZPool: sudo zpool import <POOL>