Resize a Btrfs Filesystem

The Btrfs filesystem can be resized online (when the filesystem is mounted), but if you want to resize a partition that is added to a Btrfs filesystem, you will have to do it offline (when the filesystem is not mounted). You can grow/expand or shrink a Btrfs filesystem online and grow/expand or shrink a Btrfs partition offline.

The Btrfs filesystem is a multi-device filesystem. If you have multiple devices added to your Btrfs filesystem, then you need to resize specific storage devices attached to the filesystem to resize the filesystem itself. Otherwise, you can directly resize the filesystem (as by default, the only attached storage device will be selected when you perform the resize operation).

In this article, I am going to show you how to grow/expand and shrink a Btrfs filesystem online and a Btrfs partition offline. I will also show how to resize a Btrfs filesystem that has multiple devices attached to it. So, let’s get started.

Prerequisites

To try out the examples of this article:

• You must have the Btrfs filesystem installed on your computer.
• You need to have a hard disk or SSD with at least 2 free partitions (of any size).

I have a 20 GB hard disk sdb on my Ubuntu machine. I have created 2 partitions, sdb1 and sdb2, on this hard disk. The partitions sdb1 and sdb2 are 10 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image42-2.png" data-lazy- height="291" src="data:image/svg xml,” width=”656″>

Your hard disk or SSD may have a different name than mine, so will the partitions. So, make sure to replace them with yours from now on.

If you need any assistance installing the Btrfs filesystem on Ubuntu, check my article Install and Use Btrfs on Ubuntu 20.04 LTS.

If you need any assistance installing the Btrfs filesystem on Fedora, check my article Install and Use Btrfs on Fedora 33.

Creating a Btrfs Filesystem

To experiment with resizing a Btrfs filesystem, we need to create a Btrfs filesystem. So, let’s create a Btrfs filesystem data on the partition sdb1.

To create a Btrfs filesystem with the label data on the sdb1 partition, run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image44-2.png" data-lazy- height="558" src="data:image/svg xml,” width=”628″>

Create a directory /data with the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image43-2.png" data-lazy- height="133" src="data:image/svg xml,” width=”494″>

Mount the Btrfs partition sdb1 (that you have created earlier) on the /data directory with the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image46-2.png" data-lazy- height="89" src="data:image/svg xml,” width=”550″>

As you can see, the Btrfs filesystem data mounted on the /data directory has only one storage device (sdb1) added to it, and the ID of the storage device is 1.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image45-1.png" data-lazy- height="293" src="data:image/svg xml,” width=”697″>

The size of the filesystem is 10 GB (Device size). Out of 10 GB of disk space, 9.48 GB is not used (Unallocated), 8 MB is allocated for storing data (Data, single), 512 MB is allocated for the filesystem metadata (Metadata, DUP), and 16 MB is allocated for system data (System, Dup).

The entire disk space of the partition sdb1 is on the Btrfs filesystem pool (can be used). So, 0 byte is outside of the filesystem pool ( Device slack).

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image50-2.png" data-lazy- height="293" src="data:image/svg xml,” width=”697″>

The Btrfs filesystem mounted on the /data directory is 10 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image49-2.png" data-lazy- height="148" src="data:image/svg xml,” width=”639″>

Resize a Btrfs Filesystem

You can resize the Btrfs filesystem data that you have created earlier and mounted it on the /data directory online (when it’s mounted).

For example, to shrink the Btrfs filesystem mounted on the /data directory, let’s say, by 1 GB, run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image54-2.png" data-lazy- height="130" src="data:image/svg xml,” width=”683″>

As shown in the illustration, the Btrfs filesystem removed 1 GB of disk space from the filesystem pool. You can use the slack space (Device slack) to grow/expand the Btrfs filesystem later.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image53-2.png" data-lazy- height="293" src="data:image/svg xml,” width=”739″>

Based on the image below, you can see that the Brtfs filesystem mounted on the /data directory is 9 GB in size. It was previously 10 GB.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image59-1.png" data-lazy- height="167" src="data:image/svg xml,” width=”682″>

To grow/expand the Btrfs filesystem mounted on the /data directory, let’s say, by 256 MB, run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image55-2.png" data-lazy- height="134" src="data:image/svg xml,” width=”705″>

You can see from the picture below that 256 MB of disk space is removed from the Device slack and added to the Btrfs filesystem pool.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image57-2.png" data-lazy- height="289" src="data:image/svg xml,” width=”798″>

As you can see, the Btrfs filesystem mounted on the /data directory is now 256 MB larger than before.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image60-1.png" data-lazy- height="160" src="data:image/svg xml,” width=”767″>

To grow/expand the Btrfs filesystem mounted on the /data directory to the maximum available disk space (in Device slack), run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image62-1.png" data-lazy- height="133" src="data:image/svg xml,” width=”690″>

The illustration below shows that all the available disk space from the Device slack is added to the Btrfs filesystem pool. So, the Device slack is now 0 byte in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image64-1.png" data-lazy- height="289" src="data:image/svg xml,” width=”784″>

The Btrfs filesystem mounted on the /data directory is now 10 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image66-1.png" data-lazy- height="156" src="data:image/svg xml,” width=”631″>

Resize a Btrfs Partition

You can resize a partition that is added to a Btrfs filesystem offline (when the Btrfs filesystem is not mounted).

WARNING: Be careful when you resize a partition that is added to a Btrfs filesystem as you may lose important data from the partition. Always take a backup before resizing.

As you can see, the Btrfs filesystem we have created in this article has one disk partition (sdb1) added to it. The partition is 10 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image68-1.png" data-lazy- height="294" src="data:image/svg xml,” width=”634″>

As shown in the image below,the size of the partition sdb1 is 10 GB.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image66-2.png" data-lazy- height="156" src="data:image/svg xml,” width=”631″>

Before you resize the partition, unmount the Btrfs filesystem from the /data directory with the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image69-1.png" data-lazy- height="88" src="data:image/svg xml,” width=”473″>

The name of the disk that contains the partition sdb1 is sdb.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image70-1.png" data-lazy- height="292" src="data:image/svg xml,” width=”726″>

Open the disk sdb with a disk partitioning program like fdisk as follows:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image26-4.png" data-lazy- height="256" src="data:image/svg xml,” width=”716″>

Type in p and press <Enter> to list all the existing partitions of the storage device sdb.

As you can see below, I have two partitions, sdb1 and sdb2, in the disk sdb. Let’s resize the first partition (sdb1).

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image28-4.png" data-lazy- height="324" src="data:image/svg xml,” width=”815″>

To resize a partition, you have to remove the partition, then add it again. So, you have to remember the start sector number of the partition.

For example, the start sector number of the first partition, sdb1, is 2048, as you can see in the screenshot below.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image30-4.png" data-lazy- height="324" src="data:image/svg xml,” width=”815″>

To remove a partition, type in d and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image32-3.png" data-lazy- height="70" src="data:image/svg xml,” width=”429″>

To remove the first partition (sdb1), type in 1, and press <Enter>. The partition sdb1 should be removed.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image34-4.png" data-lazy- height="141" src="data:image/svg xml,” width=”425″>

To recreate the same partition, type in n and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image36-4.png" data-lazy- height="54" src="data:image/svg xml,” width=”450″>

Type in 1 as the partition number and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image38-4.png" data-lazy- height="55" src="data:image/svg xml,” width=”499″>

Type in 2048 as the first sector number and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image39-4.png" data-lazy- height="95" src="data:image/svg xml,” width=”838″>

I want to demonstrate the process of shrinking the partition. So, I am going to create a smaller partition than before.

Type in 9G (to create a 9 GB partition) and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image40-4.png" data-lazy- height="216" src="data:image/svg xml,” width=”878″>

We would want to keep the partition signature, so type in N and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image41-3.png" data-lazy- height="262" src="data:image/svg xml,” width=”871″>

The partition should be created.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image11-11.png" data-lazy- height="348" src="data:image/svg xml,” width=”948″>

To save the changes, type in w and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image12-8.png" data-lazy- height="147" src="data:image/svg xml,” width=”602″>

Now, mount the Btrfs filesystem on the /data directory as follows:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image13-8.png" data-lazy- height="89" src="data:image/svg xml,” width=”628″>

Resize the Btrfs filesystem that is mounted on the /data directory for the changes to take effect.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image14-8.png" data-lazy- height="138" src="data:image/svg xml,” width=”690″>

You can see from the image below that the size of the sdb1 partition that is added to the Btrfs filesystem is reduced to 9 GB (from 10 GB).

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image15-9.png" data-lazy- height="291" src="data:image/svg xml,” width=”774″>

You can confirm the partition size change with the df command as well.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image16-8.png" data-lazy- height="226" src="data:image/svg xml,” width=”745″>

We can grow/expand a partition that is added to the Btrfs filesystem the same way. Let’s see how to do that.

Unmount the Btrfs filesystem that is mounted on the /data directory as follows:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image17-8.png" data-lazy- height="88" src="data:image/svg xml,” width=”629″>

Open the disk sdb with a disk partitioning program like fdisk as follows:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image18-6.png" data-lazy- height="245" src="data:image/svg xml,” width=”716″>

Now, the first partition sdb1 is 9 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image19-6.png" data-lazy- height="326" src="data:image/svg xml,” width=”799″>

The start sector number of the first partition, sdb1, is 2048.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image20-6.png" data-lazy- height="326" src="data:image/svg xml,” width=”799″>

To remove the first partition, type in d and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image1-25.png" data-lazy- height="61" src="data:image/svg xml,” width=”409″>

Type in 1 as the partition number and press <Enter>. The first partition sdb1 should be removed.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image2-28.png" data-lazy- height="148" src="data:image/svg xml,” width=”415″>

To recreate the first partition sdb1, type in n and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image3-23.png" data-lazy- height="68" src="data:image/svg xml,” width=”410″>

Type in 1 as the partition number and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image4-24.png" data-lazy- height="85" src="data:image/svg xml,” width=”477″>

Type in 2048 as the first sector number and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image5-20.png" data-lazy- height="110" src="data:image/svg xml,” width=”851″>

I will increase the partition size by 500 MB. So, the new partition size should be 9.5 GB.

Type in 9.5G and press .

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image6-17.png" data-lazy- height="217" src="data:image/svg xml,” width=”896″>

As we would want to keep the filesystem signature, let’s type in N and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image7-15.png" data-lazy- height="262" src="data:image/svg xml,” width=”900″>

The first partition, sdb1, should be recreated, and its size increased.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image8-12.png" data-lazy- height="350" src="data:image/svg xml,” width=”841″>

To save the changes, type in w and press <Enter>.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image9-11.png" data-lazy- height="126" src="data:image/svg xml,” width=”461″>

Mount the Btrfs partition sdb1 to the /data directory as follows:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image10-11.png" data-lazy- height="81" src="data:image/svg xml,” width=”624″>

Resize the Btrfs filesystem that is mounted on the /data directory for the changes to take effect.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image48-2.png" data-lazy- height="147" src="data:image/svg xml,” width=”707″>

As you can see, the partition (sdb1) size has increased to 9.5 GB (from 9 GB).

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image51-2.png" data-lazy- height="363" src="data:image/svg xml,” width=”645″>

You can confirm the partition size with the df command as well.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image52-2.png" data-lazy- height="212" src="data:image/svg xml,” width=”678″>

Resize a Multi-device Btrfs Filesystem

Btrfs is a multi-device filesystem. It means you can add multiple storage devices or partitions to a single Btrfs filesystem. In this section, I am going to show you how to resize a Btrfs filesystem that has multiple storage devices or partitions added to it. So, let’s get started.

Right now, the Btrfs filesystem that is mounted on the /data directory is 10 GB in size.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image49-3.png" data-lazy- height="148" src="data:image/svg xml,” width=”639″>

The partition sdb1 (which has the ID 1) is the only partition added to the Btrfs filesystem.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image56-2.png" data-lazy- height="292" src="data:image/svg xml,” width=”771″>

You can add another partition (let’s say, sdb2) to the Btrfs filesystem, which is mounted on the /data directory with the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image58-1.png" data-lazy- height="94" src="data:image/svg xml,” width=”661″>

The newly added partition, sdb2, of the Btrfs filesystem, which is mounted on the /data directory has the ID 2, as you can see in the screenshot below.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image61-1.png" data-lazy- height="438" src="data:image/svg xml,” width=”688″>

As you can see, the size of the Btrfs filesystem, which is mounted on the /data partition, has increased. The disk space of the sdb2 partition is added to the Btrfs filesystem.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image63-1.png" data-lazy- height="164" src="data:image/svg xml,” width=”700″>

To resize a Btrfs filesystem that has multiple storage devices added to it, you have to specify which partition of the Btrfs filesystem you want to resize. To specify the partition to resize in a Btrfs filesystem, you have to use the partition ID.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image65-1.png" data-lazy- height="399" src="data:image/svg xml,” width=”683″>

For example, to shrink the partition with the ID 1 by 2 GB of the Btrfs filesystem mounted on the /data directory, you can run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image67-1.png" data-lazy- height="137" src="data:image/svg xml,” width=”699″>

The 2 GB of disk space is removed from the partition sdb1 of the Btrfs filesystem mounted on the /data directory.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image47-2.png" data-lazy- height="402" src="data:image/svg xml,” width=”709″>

As you can see in the illustration, the Btrfs filesystem is resized (shrank) to 18 GB from 20 GB.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image23-5.png" data-lazy- height="146" src="data:image/svg xml,” width=”634″>

In the same way, you can shrink the Btrfs filesystem partition sdb2 using the partition ID 2.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image24-4.png" data-lazy- height="398" src="data:image/svg xml,” width=”718″>

To shrink the partition with the ID 2 by 1 GB of the Btrfs filesystem mounted on the /data directory, you can run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image25-4.png" data-lazy- height="131" src="data:image/svg xml,” width=”716″>

You can see that 1 GB of disk space is removed from the partition sdb2 of the Btrfs filesystem mounted on the /data directory.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image27-4.png" data-lazy- height="403" src="data:image/svg xml,” width=”793″>

The Btrfs filesystem is resized (shrank) to 17 GB from 18 GB, as shown in the image below.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image29-4.png" data-lazy- height="158" src="data:image/svg xml,” width=”668″>

To expand the partition with the ID 1 by 1 GB of the Btrfs filesystem mounted on the /data directory, you can run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image31-4.png" data-lazy- height="127" src="data:image/svg xml,” width=”728″>

As you can see, 1 GB of disk space from the partition sdb1 is added to the Btrfs filesystem pool.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image33-4.png" data-lazy- height="392" src="data:image/svg xml,” width=”600″>

Now, the Btrfs filesystem is resized (expanded) to 18 GB from 17 GB.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image35-4.png" data-lazy- height="153" src="data:image/svg xml,” width=”507″>

To expand the partition with the ID 2 by 1 GB of the Btrfs filesystem mounted on the /data directory, you can run the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image37-4.png" data-lazy- height="124" src="data:image/svg xml,” width=”745″>

You can see that 1 GB of disk space from the partition sdb2 is added to the Btrfs filesystem pool.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image21-5.png" data-lazy- height="399" src="data:image/svg xml,” width=”612″>

The Btrfs filesystem is now resized (expanded) to 19 GB from 18 GB.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2020/12/echo/image22-5.png" data-lazy- height="161" src="data:image/svg xml,” width=”501″>

Conclusion

In this article, I have shown you how to resize a Btrfs filesystem and the partitions added to a Btrfs filesystem. As well as how you can shrink or grow/expand a Btrfs filesystem and the partitions added to a Btrfs filesystem.