- Home
- Disk Defragmentation Software
- Btrfsmaintenance
Btrfsmaintenance
What it is
Btrfsmaintenance is a free collection of scripts for automating maintenance on Btrfs filesystems. It handles scrub, balance, trim, and defragmentation, with separate settings to enable, disable, or configure each task. Scrub reads filesystem data and metadata to check checksums; if a good redundant copy is available, it can repair damaged data. Periodic jobs can run through cron or systemd timers, but only one scheduling method should be active on a system. The project supports widely used Linux distributions, with Debian-based installation guidance and manual installation instructions for other systems. On SUSE-based distributions, a zypper plugin can defragment RPM database files after package installation. Configuration is set for a default setup with Btrfs on the root filesystem and can be adjusted in the documented sysconfig file. Scrub can create intense read activity, while balance can generate significant reads and writes. Task concurrency can be serialized to limit resource use or interactions. Directory defragmentation does not traverse other mount points, nested subvolumes, or snapshots; those paths need separate entries. The project is licensed under GPL-2.0 and is intended to help administer Btrfs filesystems.
For and against
For
- Automates scrub, balance, trim, and defragmentation
- Scrub can repair data when a good redundant copy exists
- Supports cron or systemd timers
- Free under GPL-2.0
Against
- Only one scheduling method can be active at a time
- Scrub can cause intense reads; balance can use substantial resources
- Defragmentation does not descend into other mount points, subvolumes, or snapshots
The verdict
Btrfsmaintenance offers configurable Btrfs maintenance tasks and scheduling without a listed price. Review the resource impact and path limitations before enabling jobs.
Who it suits
It suits Linux administrators managing Btrfs filesystems who want configurable scheduled maintenance scripts. Users should account for its resource impact and directory traversal limits.
Plans and prices
Btrfsmaintenance
GPL-2.0 · scripts for btrfs filesystem maintenance
Read 4 Oct 2026 · github.com
On the record
- API and SDK
- The repository documents shell scripts, systemd units, configuration files and a Python or shell zypper plugin; it does not document a network API or SDK.github.com · read 19 Oct 2026
- Arch availability
- Arch packages btrfsmaintenance 0.5.2-3 for the any architecture in its Extra repository and lists btrfs-progs as its dependency.archlinux.org · read 19 Oct 2026
- Balancing
- Its balance task reclaims underused Btrfs chunks using usage filters and can help avoid allocation problems caused by fragmented chunk space.github.com · read 19 Oct 2026
- Concurrency control
- The BTRFS_ALLOW_CONCURRENCY setting can serialize maintenance jobs to reduce resource contention and task interaction.github.com · read 19 Oct 2026
- Configuration
- Configuration values are designed for a default installation with btrfs on the root filesystem and can be adjusted in the documented sysconfig file.github.com · read 4 Oct 2026
- Configuration paths
- SUSE and Red Hat derivatives use /etc/sysconfig/btrfsmaintenance, while Debian derivatives use /etc/default/btrfsmaintenance.github.com · read 19 Oct 2026
- Defragmentation
- Its defrag task processes configured directories, while a separate zypper plugin defragments RPM database files after package transactions.github.com · read 19 Oct 2026
- Defragmentation limit
- Configured directory defragmentation does not descend into other mount points, nested subvolumes, or snapshots; those paths must be listed separately.github.com · read 4 Oct 2026
- Dependencies
- Debian packages depend on btrfs-progs and use either systemd or cron for scheduling.packages.debian.org · read 19 Oct 2026
- Distribution support
- The project says it supports widely used distributions, provides installation guidance for Debian based systems, and describes manual installation for other systems.github.com · read 4 Oct 2026
- Documentation depth
- The project README covers task behavior, tuning, scheduling, installation, distribution paths and snapshot-retention considerations, and release 0.5.1 added a manual page.github.com · read 19 Oct 2026
- Fedora availability
- Fedora lists btrfsmaintenance versions for Rawhide and Fedora 43 through 45, with maintainers ngompa and atim.packages.fedoraproject.org · read 19 Oct 2026
- Gentoo availability
- Gentoo offers version 0.5.2 and provides a systemd USE flag that selects systemd services and timers instead of cron timers.packages.gentoo.org · read 19 Oct 2026
- Independent adoption
- Botmonster Tech gives installation examples for Debian/Ubuntu and Fedora and shows configuration for the package's systemd timers.botmonster.com · read 19 Oct 2026
- Independent task configuration
- Scrub, balance, trim and defrag can each be enabled, disabled and configured independently through the project configuration.github.com · read 19 Oct 2026
- Installation
- Debian-based systems can use dist-install.sh, while other distributions can use distribution packages or manually install the scripts and service files.github.com · read 19 Oct 2026
- Integrations
- A zypper plugin can defragment RPM database files after package installation on SUSE based distributions.github.com · read 4 Oct 2026
- Intended audience
- The project describes its goal as helping administer btrfs filesystems and says common scripts and configurations are preferred over distribution specific ones.github.com · read 4 Oct 2026
