SANOID(8)

📦
version 2.3.0 · 3 versions
, in ubuntu resolute, ubuntu stonking

💖 SANOID(8) 💖

System Administration Utilities · a policy-driven snapshot management tool for ZFS filesystems

Hiii bestie 🫶 you've found the manual page for sanoid, section 8, and honestly? She's iconic. Policy-driven snapshot management for ZFS filesystems — say it with me now: snapshots that manage themselves. 👑

✨ NAME ✨

sanoid — a policy-driven snapshot management tool for ZFS filesystems. No cap, that's literally the whole job description. 🌸

🦋 DESCRIPTION 🦋

💅 Usage:

sanoid [options]

Assumes --cron --verbose if no other arguments (other than configdir) are specified

So like — if you just yeet sanoid at the terminal with nothing else (or only a configdir), it goes "bet" and quietly assumes --cron and --verbose for you. Main character energy. ✨

Options:

  • --configdir=DIR — Point sanoid at the directory where it should go find the config file sanoid.conf. 🎀
  • --cache-dir=DIR — Pick the directory where the ZFS snapshot cache gets stored. 🍓
  • --run-dir=DIR — Choose a directory for temporary files, like lock files and stuff. 🧚
  • --cron — Creates snapshots and purges expired snapshots. The whole glow-up in one flag. 💖
  • --verbose — Prints out additional information during a sanoid run. She's chatty, we love her. 💬
  • --readonly — Simulates creation/deletion of snapshots. Nothing actually happens, it's just pretend — rehearsal, not the show. 🙈
  • --quiet — Suppresses non-error output. Silence, but make it ✨intentional✨.
  • --force-update — Clears out sanoid's ZFS snapshot cache. Fresh start, clean slate, slay. 🌈
  • --monitor-health — Reports on zpool "health", in a Nagios compatible format. 👑
  • --monitor-capacity — Reports on zpool capacity, in a Nagios compatible format. 📊
  • --monitor-snapshots — Reports on snapshot "health", in a Nagios compatible format. 🔥
  • --take-snapshots — Creates snapshots as specified in sanoid.conf. Do the thing. ⭐
  • --prune-snapshots — Purges expired snapshots as specified in sanoid.conf. Declutter era. 💀
  • --cache-ttl=SECONDS — Set custom cache expire time in seconds (default: 20 minutes). ⏳
  • --help — Prints this helptext. Hii, that's this one. 🫶
  • --version — Prints the version number. 🏷️
  • --debug — Prints out a lot of additional information during a sanoid run. Like --verbose but she took her vitamins. 😭
ngl, --verbose and --debug are not the same vibe — one is "extra info", the other is "a LOT of additional information". Choose accordingly, bestie. 💜

and that's the whole page, you ate it 💅

Signing off: this is sanoid 2.3.0, dated August 2025. Now go make some snapshots. periodt. 💖✨🎀

📦 where this page comes from