BTRFS Scrubber

BTRFS Scrubber is an Unraid plugin that schedules periodic BTRFS scrubs with automatic rate limiting to prevent I/O stalling, keeping your pools verified on a…

  • Automation
  • Plugins
  • Tools & Utilities
BTRFS Scrubber is an Unraid plugin that schedules periodic BTRFS scrubs with automatic rate limiting to prevent I/O stalling, keeping your pools verified on a regular cycle without degrading system performance.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

39/100 Low

Maintained
71last commit 48 days ago
Popular
00 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 4 days ago

GitHub stars
0
Open issues
0
Last commit
2026-10-04
License
GPL-3.0
Activity
stale

Checked today - source: GitHub (dim-geo/btrfs-scrub-manager)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Install the Btrfs driver first Install WinBtrfs before using the scrubber, for example with Scoop: add the nonportable bucket and run scoop install winbtrfs-np -g, or with Chocolatey: choco install winbtrfs. Without this Windows driver, the scrubber cannot find or read your Btrfs drive. source
  • Run scrub from an administrator window Open PowerShell as Administrator and run rundll32.exe shellbtrfs.dll,StartScrub <drive>, replacing <drive> with a letter like D:. The command can fail silently, so check that the scrubber actually starts or that the drive shows scrub activity. source
  • Format a Btrfs drive carefully If you need to create a Btrfs partition, use format /fs:btrfs, or mkbtrfs.exe when you want extra Btrfs options. Formatting erases the selected partition, so make sure you only target a drive you can safely wipe. source
  • Schedule the scrubber with cron Run the script hourly from cron: it starts or resumes a scrub on its own, throttles it using btrfs scrub limit, and aims to finish by mid-month so the system is not stalled. source
  • Scheduling defaults Default period is one month; the script adjusts the scrub rate automatically to finish within the current cycle. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How should the scrub script be scheduled?

Run it hourly from cron. It starts or resumes a scrub on its own and uses btrfs scrub limit to try to finish before the cycle cutoff.

What happens if a scrub is already running or was interrupted?

It exits without hijacking an active scrub. It resumes an interrupted or aborted scrub, and exits until the next cycle if the previous scrub already finished.

How can I prevent a long scrub from hurting server performance?

Use a scrub scheduler that runs Btrfs scrubs only during a maintenance window. This avoids degraded server performance while the scrub completes.

What Windows setup is required before using the scrubber?

Install WinBtrfs before using the scrubber, because without the driver it cannot find or read the Btrfs drive. Run the scrub command from an administrator PowerShell window.

Answers sourced from github.com, github.com, www.reddit.com

Community

Collected 48 days ago - public community threads