CLI reference:/disk/btrfs/disk/btrfs/subvolume/disk/btrfs/transfer/disk/disk/btrfs/filesystem

info

This feature requires the Storage package.

Btrfs

Btrfs is a feature-rich copy-on-write file system. It is the default file system for some popular Linux distributions such as Fedora and is used by many large companies such as. Over the years it has proven itself to be stable and more flexible than other popular file systems. The most significant features are:

• Bitrot protection (when used in Btrfs-RAID mode).
• Subvolumes.
• Snapshots.
• Snapshot transfer between devices.

Quickstart: format a disk as Btrfs

Format a single disk to Btrfs and use it under the default mount point:

/disk/print
/disk/format <disk-name> file-system=btrfs
/disk/btrfs/filesystem/print

Once formatted, the disk appears with a new Btrfs filesystem entry under /disk/btrfs/filesystem/print, labelled <disk-name>-fs by default (the label can be changed with /disk/btrfs/filesystem/set <label> label=MyLabel). The disk mounts like any other drive and is accessible in /file. From here you can label the file system, create subvolumes and snapshots, combine several disks into a Btrfs RAID, or set up routine maintenance.

The Btrfs functionality lives under three menus:

• /disk/btrfs/filesystem - one entry per formatted Btrfs file system: labels, device membership (add-device, remove-device, replace-device), RAID profiles and maintenance jobs (balance-start, scrub-start, reset-counters).
• /disk/btrfs/subvolume - subvolumes and snapshots of a file system.
• /disk/btrfs/transfer - send and receive of snapshots to and from other devices.

See also

• Btrfs RAID - RAID1 and RAID10 setups, disk replacement, and the BraidHealthCheck script.
• Btrfs subvolumes and snapshots - creating subvolumes, taking snapshots, transferring snapshots between devices.
• Btrfs maintenance - periodic scrubbing, balancing, automated snapshot rotation, and free-space management.