Taming Disk Space Usage on My Homelab Server with btrfs Snapshots and Quotas

Introduction to Disk Space Management

I’ve been running a homelab server for a while now, and one thing that’s always been a challenge is managing disk space. With multiple services and projects running on my server, it’s easy to lose track of disk usage. I’ve seen this go wrong when you’re not paying attention, and suddenly you’re scrambling to free up space. Recently, I started exploring ways to better manage my disk space, and I stumbled upon btrfs snapshots and quotas. In practice, these features have been a game-changer for me.

What is btrfs?

btrfs (B-tree file system) is a file system that offers advanced features like snapshotting, subvolumes, and quotas. It’s been around since 2007, and I’ve been impressed by its flexibility and reliability. One of the key benefits of btrfs is its ability to create snapshots, which are read-only copies of a subvolume at a particular point in time. This feature allows me to easily track changes to my file system and revert to a previous state if needed. Don’t bother with other file systems if you need this level of control - btrfs is the way to go.

Setting up btrfs

To get started with btrfs, I first needed to create a btrfs file system on my disk. I used the mkfs.btrfs command to format my disk:

sudo mkfs.btrfs /dev/sda1

Next, I mounted the btrfs file system:

sudo mount /dev/sda1 /mnt

This is where people usually get burned - they forget to mount the file system, and then they’re wondering why nothing is working.

Creating Subvolumes

btrfs uses subvolumes to organize data. Subvolumes are like directories, but they’re treated as separate entities by the file system. I created a subvolume for my homelab data:

sudo btrfs subvolume create /mnt/homelab

The real trick is to keep your subvolumes organized, so you can easily manage your data.

Enabling Quotas

Quotas allow me to set limits on disk usage for each subvolume. I enabled quotas on my btrfs file system:

sudo btrfs quota enable /mnt

This is a crucial step - without quotas, you’re not really managing your disk space.

Setting Quota Limits

I set a quota limit for my homelab subvolume:

sudo btrfs qgroup limit 10G /mnt/homelab

This sets a limit of 10GB for the homelab subvolume. In practice, this means I can prevent any one service from hogging all the disk space.

Creating Snapshots

I created a snapshot of my homelab subvolume:

sudo btrfs snapshot create /mnt/homelab/snapshot

This creates a read-only copy of my homelab subvolume at the current point in time. I usually start with a snapshot, just in case something goes wrong.

Managing Snapshots

I can list all snapshots on my btrfs file system:

sudo btrfs subvolume list /mnt

I can also delete a snapshot:

sudo btrfs subvolume delete /mnt/homelab/snapshot

Be careful when deleting snapshots - you don’t want to lose important data.

Security Considerations

When using btrfs snapshots and quotas, it’s essential to consider security implications. Since snapshots are read-only, they can provide a secure way to preserve data in case of a security breach. However, it’s crucial to ensure that snapshots are properly secured and access-controlled. I use systemd to manage access to my btrfs file system and ensure that only authorized users can create and manage snapshots.

Troubleshooting

If I encounter issues with my btrfs file system, I can use the btrfs filesystem show command to diagnose problems:

sudo btrfs filesystem show /mnt

This command provides detailed information about my btrfs file system, including disk usage and error messages. I’ve found this command to be incredibly useful when troubleshooting issues.

Next Steps

Implementing btrfs snapshots and quotas has significantly improved my disk space management on my homelab server. With these features, I can easily track changes to my file system, set limits on disk usage, and ensure that my data is secure. For more information on btrfs, I recommend visiting the btrfs wiki on kernel.org. I’ll continue to refine my btrfs setup to optimize disk space usage and ensure the reliability of my homelab server.