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…
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
Variants
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
- How are you guys automating your btrfs scrubs? : r/Fedora - Reddit (reddit)
- btrfs-scrub-scheduler: scrub your BTRFS only during the ... - Reddit (reddit)
- How to take care of your BTRFS filesystem health (on Atomic Desktops) (forum)
- BTRFS: how to create a sheduled scrub job? - openmediavault (forum)
- Questions about btrfs scrub : r/btrfs - Reddit (reddit)
- What's the benefit of btrfs-scrub when you only have one drive? (forum)
Collected 48 days ago - public community threads