BTRFS

What is it?

BTRFS is a modern file system that is available on Linux gaining more traction in general-purpose distributions. It has become mature and stable and should be considered an option for IPFire users, too.

Who is working on it?

• Stefan Schantl

Current Status

• Targeted Release: Core 202+
• Tracker Bug: #13606
• Testing Images

Description

The work mainly touches the installer program which has to create a new filesystem and configure the system accordingly. Slight changes need to be made in the core system to make easy booting into snapshots possible.

Benefits to IPFire

A strict filesystem layout has become a problem on IPFire as the distribution is fast-changing. BTRFS allows more flexibility around this and brings modern filesystem features to IPFire, too.

• Instant snapshots due to COW
• Checksummed filesystems
• Compressed filesystems for better use of physical space

Impact

• Users cannot migrate to a different filesystems, so a re-installation is needed to gain this functionality. On existing systems there is no impact expected.

Documentation

• BTRFS on Wikipedia
• Linux Kernel Documentation
• Development git repository

Feedback

None, yet.

Dependencies

None.

Release Notes

Initial BTRFS support is part since core update 186.

This mainly allowed to choose BTRFS as filesystem when doing a fresh installation of IPFire.

All the partitioning and creation of necessary subvolumes is done by the installer. Please note that when using BTRFS the partition layout will be a bit different than on any other filesystem, because there is no separate partition for boot anymore.

We enabled the compress feature of BTRFS, which transparently compresses files when writing to disk with zstd and therefore will save some space.

UPDATE (29.04.2026):

A new section on the backup CGI page will be shown to manually create, delete and restore the snapshots. This section only will be displayed in case BTRFS has been choosen as filesystem during installation.
(Page may needs a bit more attention and styling...)

The grub boot menu has been extended to easily boot into an existing snapshot in case the system has been corrupted.

The pakfire package manager automatically will create a snapshot when upgrading to a new core version. This allows an easy roll-back, in case any problems occur with the newer core and should allow better testing of developent releases.

The "experimental" mark for BTRFS during installation has been removed.