bup-fuse(1)

📦
version 0.34 · 10 versions
, in fedora 44, nixpkgs unstable

🦋 bup-fuse — bestie, it's the bup-fuse(1) page 💅

✨ NAME ✨

bup-fuse — mount a bup repository as a filesystem 🎀

🌸 SYNOPSIS 🌸

bup fuse [-d] [-f] [-o] <mountpoint>

💖 DESCRIPTION 💖

okay so bup fuse opens up a bup repository and exports it as a fuse(7) userspace filesystem. literally turning your backups into a whole filesystem you can just… walk around in. iconic behaviour, no cap 🫶

this feature is only available on systems that support FUSE (Linux and its friends, iykyk) ✨

⚠️ WARNING: bestie. listen. bup fuse is still experimental and it does not enforce any file permissions! every single file will be readable by all users. all of them. the whole group chat. so like… vibe check before you mount this on anything public, fr fr 💀

when you're done accessing the mounted fuse filesystem, you should unmount it with umount(8). don't just ghost it, that's rude 🥺

🎀 OPTIONS 🎀

  • -d, --debug — run in the foreground and print FUSE debug info for literally every single request. it's giving very chatty. very 👀
  • -f, --foreground — run in the foreground and exit only when the filesystem is unmounted. it stays put until you say so 💅
  • -o, --allow-other — permit other users to access the filesystem. necessary for exporting the filesystem via Samba, for example. sharing is caring, but like, be careful 🌈
  • --meta — report some of the original metadata (when available) for the mounted paths — currently the uid, gid, mode, and timestamps. without this, only generic values get presented. this option is not yet enabled by default because it may negatively affect performance, and note that any timestamps before 1970-01-01 UTC (i.e. before the Unix epoch) will be presented as 1970-01-01 UTC. so that ancient vibe is getting rounded up to the epoch, sorry bestie 😭
  • -v, --verbose — increase verbosity (can be used more than once). stack those -vs like they're scrunchies 🎀

🌈 EXAMPLES 🌈

okay here's the lil demo flow, copy-paste and slay:

rm -rf /tmp/buptest
mkdir /tmp/buptest
sudo bup fuse -d /tmp/buptest
ls /tmp/buptest/*/latest
...
umount /tmp/buptest

👑 SEE ALSO 👑

fuse(7), fusermount(1), bup-ls(1), bup-ftp(1), bup-restore(1), bup-web(1)

🧚 BUP 🧚

part of the bup(1) suite. the whole squad 🫶

💜 AUTHORS 💜

Avery Pennarun apenwarr@gmail.com

and that's the whole page bestie, go forth and mount responsibly ✨

Bup 0.34 — dated 2026-09-01 — from the bup-fuse(1) manual, mwah 💋💖

📦 where this page comes from