Btrfs: the b-tree filesystem
Btrfs is a copy-on-write filesystem for Linux aimed at implementing advanced features including error detection, fault tolerance, recovery, transparent compression, cheap snapshots, integrated volume management, and easy administration. It provides multiple device storage pooling, RAID-like functionality, fast snapshot creation, and checksumming of data and metadata. Contributors include Facebook, Fujitsu, (open)SUSE, Oracle, and Western Digital. Btrfs is licensed under the GPL and open for contribution from anyone.
Default filesystem, on the desktop
- Btrfs is the default file system for desktops, starting with Fedora 33. See the Change Proposal
- Fedora Magazine: Btrfs Coming to Fedora 33
- Bugs related to
btrfsuser-space commands should be filed against the btrfs-progs component.
- All other bugs should be filed against the kernel component. Following submission of the bug, please set the Assignee field to: email@example.com and Save the change.
- The Fedora installer, Anaconda, uses Btrfs by default in desktop editions and spins; and as an option in Manual Partitioning for Server, Cloud, and IoT editions. Fedora CoreOS installer, Ignition, also supports Btrfs as an option.
- The Btrfs partition scheme preset creates an ext4 /boot, and a Btrfs pool. Two subvolumes, root and home, are created from that pool and mounted at / and /home respectively.
- Additional mount points using Btrfs will also have corresponding subvolumes created based on the Name field. Subvolumes do not have a size, so the Desired Capacity field when creating new mount points is ignored and can be left blank.
Recommended reading for users
man 5 btrfs— info about btrfs itself: mount options, features, limits, swapfile support, the case of multiple block group profiles
man btrfs— btrfs user space commands overview
man btrfs <command>— man page for this specific btrfs command, e.g.
man btrfs device. NOTE: Any command name can be shortened so long as the shortened form is unambiguous, e.g.
btrfs fi usis equivalent to
btrfs filesystem usage.
man mkfs.btrfs— man page for the mkfs command, includes info on block groups, chunks, raid, multiple device layouts, profiles, redundancy, space utilization, and minimum devices.
- linux-raid@ list: Timeout Mismatch
- linux-btrfs@ list: How to use btrfs raid5 successfully(ish)
Btrfs commands for LVM users
- Collection of documents that describe internals of the BTRFS filesystem.
- Btrfs Wiki: Developer's FAQ, contributing to Btrfs.
Conversions from Ext3/Ext4 volumes to Btrfs (and back!)
- Btrfs Wiki has more information on conversion and rollback.