Need help with grub-btrfs?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

145 Stars 34 Forks GNU General Public License v3.0 225 Commits 2 Opened issues


Include btrfs snapshots at boot options. (Grub menu)

Services available


Need anything else?

Contributors list

GitHub release


This is a version 4.xx of grub-btrfs

BTC donation address:


Improves Grub by adding "btrfs snapshots" to the Grub menu.

You can start your system on a "snapshot" from the Grub menu.
Supports manual snapshots, snapper, timeshift ...

Warning: booting on read-only snapshots can be tricky

If you choose to do it,

or even
must be on a separate subvolume.
Otherwise, make sure your snapshots are writeable.
See this ticket for more info.

This project includes its own solution.
Refer to the documentation.

What does grub-btrfs v4.xx do :

  • Automatically List snapshots existing on root partition (btrfs).
  • Automatically Detect if "/boot" is in separate partition.
  • Automatically Detect kernel, initramfs and intel/amd microcode in "/boot" directory on snapshots.
  • Automatically Create corresponding "menuentry" in
  • Automatically detect snapper and use snapper's snapshot description if available.
  • Automatically generate
    if you use the provided systemd service.

Installation :

Arch Linux

pacman -S grub-btrfs


  • Run
    make install
    or look into Makefile for instructions on where to put each file.

NOTE: Generate your Grub menu after installation for the changes to take effect.
On Arch Linux use

grub-mkconfig -o /boot/grub/grub.cfg


You have the possibility to modify many parameters in

See config file for more information.

Automatically update grub

If you would like Grub to automatically update when a snapshot is made or deleted: * Use

systemctl start/enable grub-btrfs.path
. *
automatically (re)generates
when a modification appears in
folder (by default). * If your snapshots aren't mounted in
, you must modify the watch folder using
systemctl edit grub-btrfs.path
* For example: Timeshift mount its snapshots in
    Use `systemctl edit grub-btrfs.path`.
    Then wrote:
    and finally save.
* You can view your change to `systemctl cat grub-btrfs.path`.
* To revert change use `systemctl revert grub-btrfs.path`.

by default,

command is used.
Might be
on some systems (Fedora ...).
variable in
file to reflect this.

Special thanks for assistance and contributions

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.