Btrfs is a new copy on write (CoW) filesystem for Linux aimed at implementing advanced features while focusing on fault tolerance, repair and easy administration. Jointly developed at Oracle, Red Hat, Fujitsu, Intel, SUSE, STRATO and many others, Btrfs is licensed under the GPL and open for contribution from anyone.
Btrfs is under heavy development, but every effort is being made to keep the filesystem stable and fast. Because of the speed of development, you should run the latest kernel you can (either the latest release kernel from kernel.org, or the latest -rc kernel. Please email the Btrfs mailing list if you have any problems or questions while using Btrfs.
Linux has a wealth of filesystems from which to choose, but we are facing a number of challenges with scaling to the large storage subsystems that are becoming common in today's data centers. Filesystems need to scale in their ability to address and manage large storage, and also in their ability to detect, repair and tolerate errors in the data stored on disk.
The main Btrfs features available at the moment include:
- Extent based file storage
- 2^64 byte == 16 EiB maximum file size
- Space-efficient packing of small files
- Space-efficient indexed directories
- Dynamic inode allocation
- Writable snapshots, read-only snapshots
- Subvolumes (separate internal filesystem roots)
- Checksums on data and metadata (crc32c)
- Compression (zlib and LZO)
- Integrated multiple device support
- File Striping, File Mirroring, File Striping+Mirroring, Striping with Single and Dual Parity implementations
- SSD (Flash storage) awareness (TRIM/Discard for reporting free blocks for reuse) and optimizations (e.g. avoiding unnecessary seek optimizations, sending writes in clusters, even if they are from unrelated files. This results in larger write operations and faster write throughput)
- Efficient Incremental Backup
- Background scrub process for finding and fixing errors on files with redundant copies
- Online filesystem defragmentation
- Offline filesystem check
- Conversion of existing ext3/4 file systems
- Seed devices. Create a (readonly) filesystem that acts as a template to seed other Btrfs filesystems. The original filesystem and devices are included as a readonly starting point for the new filesystem. Using copy on write, all modifications are stored on different devices; the original is unchanged.
- Subvolume-aware quota support
- Send/receive of subvolume changes
- Efficient incremental filesystem mirroring
Additional features in development, or planned, include:
- Very fast offline filesystem check
- Object-level mirroring and striping
- Alternative checksum algorithms
- Online filesystem check
- Other compression methods (snappy, lz4)
- Hot data tracking and moving to faster devices (currently being pushed as a generic feature available through VFS)
- Deduplication (online, offline)
Coming in 3.10 (highlights or user visible changes)
- reduced size of metadata by so-called skinny extents 
- enhanced syslog message format 
- the mount option subvolrootid is deprecated
- lots of stability improvements, removed many BUG_ONs
- qgroups are automatically created when quotas are enabled 
- qgroups are able to rescan current filesystem and sync the quota state with the existing subvolumes
- enhanced send/recv format for multiplexing more data into one stream 
- various unsorted code cleanups, minor performance updates
Enterprise btrfs support (Feb 2012)
- Since February 2012 there are two vendors who support btrfs in their distributions, Oracle and SUSE.
Read about past releases in the Changelog
Articles, presentations, podcasts
- Article: A Beginner's Guide To Btrfs (2012-11-26)
- Article: How I Use the Advanced Capabilities of Btrfs by Margaret Bierman with Lenz Grimmer (2012-08-11)
- Article: How I Got Started with the Btrfs File System for Oracle Linux by Margaret Bierman with Lenz Grimmer (2012-07-11)
- Paper: draft describing the overall concepts and architecture, to appear in ACM Transactions on Stroage 2013.
- Article: Btrfs Fun Wiki page on funtoo.org (2012-05)
- Video: Btrfs Filesystem: Status and New Features by Chris Mason at the 2012 Linux Foundation Collaboration Summit (2012-04-05)
- Article Btrfs - The Swiss Army Knife Of Storage by Josef Bacik (2012-02)
- Video: I Can't Believe This is Butter! A tour of btrfs by Avi Miller at linux.conf.au (2012-01-18)
- Article: A btrfs update at LinuxCon Europe on lwn.net (2011-11-02)
- Podcast: Podcast with Chris Mason: Btrfs overview and status update (2011-07-13)
- Video: The Story So Far by Josef Bacik at LinuxCon Brazil (2010-08-31)
- Article: Linux.com Weekend Project: Get Started with Btrfs (2010-10-15)
- Webcast: State of "Btrfs" File System for Linux by Chris Mason (2010-08-26) [email registration and flash required]
- Article: Valerie Aurora: A short history of btrfs (2009-07-22)
Guides and usage information
- Getting started — first steps, distributions with btrfs support
- FAQ — About the btrfs project and filesystem
- UseCases — Recipes for how to do stuff with btrfs
- SysadminGuide — A more in-depth guide to btrfs' concepts and a bit of its internals, to answer all those "but what is a subvolume?" kind of questions.
- Multiple devices – A guide to the RAID features of Btrfs
- Conversion from Ext3 and Ext4
- Problem FAQ — Commonly-encountered problems and solutions.
- Gotchas — lists known bugs and issues, but not necessarily solutions.
- Changelog — history of changes in linux kernel wrt btrfs
- Contact information:
- Project ideas
- Cleanup ideas
Using the built-in tools
- btrfs — main administration tool
- mkfs.btrfs — creating the filesystem
- btrfsck — repairing file systems
- restore and find-root — utilities to find and restore data from an unmountable filesystem
- btrfs-convert — tool to convert in-place from ext2/3/4 filesystems to btrfs
- Code documentation — trees, source files, sample code for manipulating trees
- Data Structures — detailed on-disk data structures
- Trees — detailed in-tree representation of files and directories
- Btrfs design — design notes (possibly out of date in places)
- Multiple Device Support — design notes
- ENOSPC — Current ENOSPC design issues
- Debugging Btrfs with GDB
- Writing patch for btrfs
- Unmerged Patches — patches with different features from btrfs mailing list
Source code download
- 2012-10 BTRFS, mount options and virtual machines: an in-depth look (Ilsistemista.net)
- 2012-06 BTRFS EXT3 EXT4 XFS and KVM virtual machine: a host-side filesystem comparison (Ilsistemista.net)
- 2012-06 BTRFS vs EXT3 vs EXT4 vs XFS performance on Fedora 17 (Ilsistemista.net)
- 2012-05 XFS, Btrfs, EXT4 Battle It Out On Linux 3.4 (Phoronix.com)
- 2012-05 Ext4, XFS and Btrfs benchmark redux
- 2012-03 Testing Out The Btrfs Mount Options On Linux 3.2 (Phoronix.com)
- 2012-03 Ubuntu 12.04 LTS - Benchmarking All The Linux File-Systems (Phoronix.com)
- 2011-12 Btrfs Performance Analysis
- 2011-11 Testing The "Pretty Beefy" Btrfs Changes In Linux 3.2 (Phoronix.com)
- 2011-10 EXT3 vs EXT4 vs XFS vs BTRFS - filesystems comparison on Linux kernel 3.0.0 (Ilsistemista.net)
- 2011-09 Testing EXT4 & Btrfs On A Serial ATA 3.0 SSD (Phoronix.com)
- 2011-05 Linux 2.6.39: XFS Speeds-Up, EXT4 & Btrfs Unchanged (Phoronix.com)
- 2011-03 Btrfs LZO Compression Performance (Phoronix.com)
- 2010-12 Benchmarks Of The Btrfs Space Cache Option (Phoronix.com) Comparing the performance of Btrfs using the default mount options, using the space_cache mount option, using the compress mount option for Btrfs file compression, and lastly using both the space_cache and compression mount options to benefit from the free space caching and Zlib compression.
- 2010 SSD Linux benchmarking: Comparing filesystems and encryption method
- 2010-11 EXT3 vs EXT4 vs XFS vs BTRFS linux filesystems benchmark (Ilsistemista.net)
- 2010-11 Phoronix: The Linux 2.6.37 Kernel With EXT4 & Btrfs (Phoronix.com) Comparison between Btrfs and Ext4.
- 2010-10 One Billion Files Btrfs performs well in comparison to other filesystems, when there are a billion files in the filesystem.
- 2009-05 Phoronix Test With SSD Mode (Phoronix.com) This test show that btrfs is slower with ssd option activated. Ssd code has been updated during 2.6.30-rc and is expected to be faster.
- 2009-04 Phoronix Performance Test on Fedora 11 Preview (Phoronix.com) The phoronix workload is mostly CPU based, but they do have a few filesystem benchmarks. Btrfs performs well, but you can see the checksumming and metadata duplication show up on their single disk streaming write workload. dbench in general measures lots of different caching effects, and is not a great measure of everyday performance.
- 2008-10 Btrfs performance analysis by Steven Pratt and IBM The benchmarks from IBM demonstrate some bottlenecks we have in the extent recording on large workloads. We're working on fixes for these.
- 2008-04 Multi-device Benchmarks