# 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 regular cycle without degrading system performance. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4165/btrfs-scrubber

## Description

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.

## Health score

39/100 (Low), based on 3 of 4 factors.
- Maintained: 71 (last commit 48 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/btrfs-scrubber-1apt1ja13bx93e?q=BTRFS%20Scrubber
- GitHub: https://github.com/dim-geo/btrfs-scrub-manager

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/4165/btrfs-scrubber), the self-hosted and open-source app directory.
