https://github.com/zygo/bees

Best-Effort Extent-Same, a btrfs dedupe agent
https://github.com/zygo/bees

btrfs dedup dedupe

Last synced: 3 months ago
JSON representation

Best-Effort Extent-Same, a btrfs dedupe agent

• Host: GitHub
• URL: https://github.com/zygo/bees
• Owner: Zygo
• License: gpl-3.0
• Created: 2016-11-17T05:07:46.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2026-02-14T05:25:09.000Z (4 months ago)
• Last Synced: 2026-02-14T13:43:42.302Z (4 months ago)
• Topics: btrfs, dedup, dedupe
• Language: C++
• Homepage:
• Size: 1.28 MB
• Stars: 912
• Watchers: 24
• Forks: 65
• Open Issues: 157
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

          
BEES

====

Best-Effort Extent-Same, a btrfs deduplication agent.

About bees

----------

bees is a block-oriented userspace deduplication agent designed to scale

up to large btrfs filesystems.  It is an offline dedupe combined with

an incremental data scan capability to minimize time data spends on disk

from write to dedupe.

Strengths

---------

 * Space-efficient hash table - can use as little as 1 GB hash table per 10 TB unique data (0.1GB/TB)

 * Daemon mode - incrementally dedupes new data as it appears

 * Largest extents first - recover more free space during fixed maintenance windows

 * Works with btrfs compression - dedupe any combination of compressed and uncompressed files

 * Whole-filesystem dedupe - scans data only once, even with snapshots and reflinks

 * Persistent hash table for rapid restart after shutdown

 * Constant hash table size - no increased RAM usage if data set becomes larger

 * Works on live data - no scheduled downtime required

 * Automatic self-throttling - reduces system load

 * btrfs support - recovers more free space from btrfs than naive dedupers

Weaknesses

----------

 * Whole-filesystem dedupe - has no include/exclude filters, does not accept file lists

 * Requires root privilege (`CAP_SYS_ADMIN` plus the usual filesystem read/modify caps)

 * [First run may increase metadata space usage if many snapshots exist](docs/gotchas.md)

 * Constant hash table size - no decreased RAM usage if data set becomes smaller

 * btrfs only

Installation and Usage

----------------------

 * [Installation](docs/install.md)

 * [Configuration](docs/config.md)

 * [Running](docs/running.md)

 * [Command Line Options](docs/options.md)

Recommended Reading

-------------------

 * [bees Gotchas](docs/gotchas.md)

 * [btrfs kernel bugs](docs/btrfs-kernel.md) - especially DATA CORRUPTION WARNING for old kernels

 * [bees vs. other btrfs features](docs/btrfs-other.md)

 * [What to do when something goes wrong](docs/wrong.md)

More Information

----------------

 * [How bees works](docs/how-it-works.md)

 * [Missing bees features](docs/missing.md)

 * [Event counter descriptions](docs/event-counters.md)

Bug Reports and Contributions

-----------------------------

Email bug reports and patches to Zygo Blaxell .

You can also use Github:

        https://github.com/Zygo/bees

Copyright & License

-------------------

Copyright 2015-2025 Zygo Blaxell .

GPL (version 3 or later).