# Install btrfs-progs with Homebrew, apk, apt, dnf, Nix, pacman, zypper Userspace utilities to manage btrfs filesystems. Version 7.0 via Homebrew; verified 2026-05-10. ## Install ```sh sudo av install brew:btrfs-progs ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install btrfs-progs ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add btrfs-progs ``` Evidence: Alpine Linux edge package indexes: btrfs-progs from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install btrfs-progs ``` Evidence: Debian stable package indexes: btrfs-progs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install btrfs-progs ``` Evidence: Fedora Rawhide package metadata: btrfs-progs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#btrfs-progs ``` Evidence: nixpkgs package indexes: pkgs/by-name/bt/btrfs-progs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S btrfs-progs ``` Evidence: Arch Linux sync databases: btrfs-progs from https://geo.mirror.pkgbuild.com/core/os/x86_64/core.db.tar.gz - zypper (92%): ```sh sudo zypper install btrfsprogs ``` Evidence: openSUSE Tumbleweed package metadata: btrfsprogs from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:btrfs-progs - **Package manager:** Homebrew - **Package manager page:** - **Version:** 7.0 - **Source summary:** Userspace utilities to manage btrfs filesystems - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-only AND LGPL-2.1-or-later - **Source archive:** - **Last updated:** 2026-05-10T04:40:50Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - btrfs (cli) - btrfs-convert (cli) - btrfs-find-root (cli) - btrfs-image (cli) - btrfs-map-logical (cli) - btrfs-select-super (cli) - btrfsck (cli) - btrfstune (cli) - fsck.btrfs (cli) - mkfs.btrfs (cli) - btrfs (alias) - btrfs-convert (alias) - btrfs-find-root (alias) - btrfs-image (alias) - btrfs-map-logical (alias) - btrfs-select-super (alias) - btrfsck (alias) - btrfstune (alias) - fsck.btrfs (alias) - mkfs.btrfs (alias) ## Dependencies - e2fsprogs - lzo - systemd - util-linux - zlib-ng-compat - zstd ## Build dependencies - pkgconf - python-setuptools - python@3.14 - sphinx-doc ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 7.0 - Package-manager updated: 2026-05-10 - Local data: ok - Upstream repository: https://btrfs.readthedocs.io/en/latest/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage btrfs-progs is the userspace tool suite for administering Btrfs filesystems. It is the command-line half of a major Linux filesystem: mkfs, check, rescue, send/receive, subvolume, device, balance, scrub, image, and related tools all live here. ### Project history Btrfs is documented as a modern copy-on-write filesystem for Linux focused on advanced features, fault tolerance, repair, and easy administration. btrfs-progs packages the tools and manual pages needed to create and operate those filesystems from userspace. The btrfs-progs repository hosts the main btrfs administration command, mkfs.btrfs, libbtrfsutil C and Python bindings, manual pages, and documentation sources. Its release cycle is time-based and follows Linux kernel releases, with signed tags and tarballs hosted on kernel.org. The GitHub mirror/repository metadata shows public repository creation in 2013, while the tool history follows Btrfs itself and its kernel/userspace split. The project deliberately tracks kernel feature compatibility: btrfs-progs version X.Y declares support for kernel features of the same version. ### Adoption history btrfs-progs is packaged broadly because Btrfs administration requires matching userspace tools. The input metadata lists Alpine, Homebrew, Debian, Fedora/dnf, Nix, Arch/pacman, Ubuntu, and openSUSE/zypper packaging. Adoption grew with Btrfs use in Linux distributions, storage appliances, snapshotting workflows, rollback systems, container hosts, and developer machines that want cheap snapshots, checksummed metadata/data, compression, and send/receive replication. Homebrew packaging is mostly for tooling and cross-platform workflows rather than native macOS filesystem administration, because Btrfs itself is a Linux filesystem. ### How it is used The main btrfs command is the administration entry point, while mkfs.btrfs creates filesystems. Other tools support conversion, image capture, rescue, check, logical mapping, tuning, superblock selection, and fsck integration. Common workflows include creating a filesystem, mounting it with Btrfs-specific options, creating subvolumes and snapshots, balancing allocation profiles, scrubbing for checksum errors, replacing devices, and using send/receive for incremental replication. There is no general per-user credentials file. Configuration is primarily filesystem state, mount options, kernel interfaces, and command-line usage rather than a single application config file. ### Why package nerds care btrfs-progs is significant because it is the package-manager face of a Linux filesystem. Updating it is not cosmetic: userspace/kernel feature compatibility, rescue environments, static binaries, and signed release provenance all matter. It is also a good example of packaging a tool suite whose safest operation depends on kernel behavior, hardware characteristics, and filesystem feature flags. Package maintainers care about version alignment, release notes, and conservative defaults more than a single executable. ### Timeline - 2013: Public GitHub repository metadata records creation of kdave/btrfs-progs. - 2010s: btrfs-progs matures alongside Btrfs kernel support and distribution adoption. - 2020s: Release cycle follows Linux kernel releases, with signed release tags and kernel.org tarballs. - 2026: GitHub tags include v7.0 and late 6.x releases, reflecting ongoing maintenance. ### Related projects - Btrfs is the Linux copy-on-write filesystem administered by btrfs-progs. - The Linux kernel contains the filesystem implementation whose feature set btrfs-progs tracks. - libbtrfsutil provides C and Python bindings for some Btrfs userspace operations. - BusyBox-style standalone btrfs.box builds support rescue and constrained environments. ### Sources - - - - - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for btrfs-progs. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** btrfs-progs - **Version Scheme:** 0 - **Revision:** 0 - **Requirements:** linux - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - btrfs-progs - 6.14-1: normalized package name match | Debian stable package indexes: btrfs-progs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities | http://btrfs.wiki.kernel.org/ - Debian apt - libbtrfs-dev - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfs-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (development headers) | http://btrfs.wiki.kernel.org/ - Debian apt - libbtrfs0t64 - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfs0t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (runtime library) | http://btrfs.wiki.kernel.org/ - Debian apt - libbtrfsutil-dev - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfsutil-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (util development headers) | http://btrfs.wiki.kernel.org/ - Debian apt - libbtrfsutil1t64 - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfsutil1t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (runtime util library) | http://btrfs.wiki.kernel.org/ - Debian apt - python3-btrfsutil - 6.14-1: normalized package name match | Debian stable package indexes: python3-btrfsutil from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (python3 bindings) | http://btrfs.wiki.kernel.org/ - Nix - btrfs-progs: normalized package name match | nixpkgs package indexes: pkgs/by-name/bt/btrfs-progs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - btrfs-progs - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: btrfs-progs from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities | http://btrfs.wiki.kernel.org/ - Ubuntu apt - libbtrfs-dev - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfs-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (development headers) | http://btrfs.wiki.kernel.org/ - Ubuntu apt - libbtrfs0t64 - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfs0t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (runtime library) | http://btrfs.wiki.kernel.org/ - Ubuntu apt - libbtrfsutil-dev - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfsutil-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (util development headers) | http://btrfs.wiki.kernel.org/ - Ubuntu apt - libbtrfsutil1t64 - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfsutil1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (runtime util library) | http://btrfs.wiki.kernel.org/ - Ubuntu apt - python3-btrfsutil - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-btrfsutil from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (python3 bindings) | http://btrfs.wiki.kernel.org/ - apk - btrfs-progs - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | BTRFS filesystem utilities | https://btrfs.wiki.kernel.org - apk - btrfs-progs-bash-completion - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Bash completions for btrfs-progs | https://btrfs.wiki.kernel.org - apk - btrfs-progs-dev - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs-dev from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | BTRFS filesystem utilities (development files) | https://btrfs.wiki.kernel.org ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Matched curated package taxonomy and local package facts. - [e2fsprogs](https://www.automicvault.com/pkg/brew/e2fsprogs/) - Runtime dependency declared by Homebrew. - [systemd](https://www.automicvault.com/pkg/brew/systemd/) - Runtime dependency declared by Homebrew. - [util-linux](https://www.automicvault.com/pkg/brew/util-linux/) - Runtime dependency declared by Homebrew. - [zstd](https://www.automicvault.com/pkg/brew/zstd/) - Runtime dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Build dependency declared by Homebrew. - [sphinx-doc](https://www.automicvault.com/pkg/brew/sphinx-doc/) - Build dependency declared by Homebrew. - [dysk](https://www.automicvault.com/pkg/brew/dysk/) - Shares av.db curated category or tags: cli, filesystem, filesystems, linux, system. - [erofs-utils](https://www.automicvault.com/pkg/brew/erofs-utils/) - Shares av.db curated category or tags: cli, filesystem, filesystems, linux, system. - [squashfs](https://www.automicvault.com/pkg/brew/squashfs/) - Shares av.db curated category or tags: cli, filesystem, filesystems, linux, system. - [btfs](https://www.automicvault.com/pkg/brew/btfs/) - Shares av.db curated category or tags: cli, filesystem, filesystems, system. - [dosfstools](https://www.automicvault.com/pkg/brew/dosfstools/) - Shares av.db curated category or tags: cli, filesystem, filesystems, system. - [dwarfs](https://www.automicvault.com/pkg/brew/dwarfs/) - Shares av.db curated category or tags: cli, filesystem, filesystems, system. - [e2tools](https://www.automicvault.com/pkg/brew/e2tools/) - Shares av.db curated category or tags: cli, filesystem, filesystems, system. - [squashfuse](https://www.automicvault.com/pkg/brew/squashfuse/) - Local package facts share a topical domain. Shared terms: cli, compat, filesystem, filesystems, lzo. - [ratarmount](https://www.automicvault.com/pkg/brew/ratarmount/) - Local package facts share a topical domain. Shared terms: cli, compat, filesystem, filesystems, system. ## Combined YAML source View the package source record on GitHub. [combined/btrfs-progs.yml](https://github.com/automic-vault/db/blob/main/combined/btrfs-progs.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph