RBD-FUSE(8)

✨ rbd-fuse ✨

okay bestie, welcome to rbd-fuse, which lives in section 8 of the manual (that's the sysadmin-y section, iykyk) πŸ’… it's the little tool that exposes your rbd images as files. yes, literally as files. sit with that for a sec πŸ¦‹


🌸 SYNOPSIS 🌸

rbd-fuse [ -p pool ] [-c conffile] mountpoint [ fuse options ]

like, that's the whole vibe check right there πŸ’–


🚨 NOTE 🚨

okay so real talk for one second: rbd-fuse is not recommended for any production or high performance workloads. not "meh, it's fine", not "depends on your setup" β€” just no. keep it for the chill stuff, bestie πŸ™ˆ


πŸ’« DESCRIPTION πŸ’«

rbd-fuse is a FUSE client β€” and FUSE stands for "Filesystem in USErspace", which is genuinely iconic of the naming committee β€” built for RADOS block device (rbd) images. πŸ‘‘

so here's the tea: you give it a pool that's got rbd images hangin' out in it, and it mounts a userspace file system for you where all those images show up as regular files at your mountpoint. that's it. that's the whole magic trick ✨

and when you're done and you wanna bounce, you unmount it like this:

fusermount -u mountpoint

or, if you'd rather be dramatic about it, you just send SIGINT to the rbd-fuse process 😌 either one works, pick your main character moment.


πŸŽ€ OPTIONS πŸŽ€

heads up: any options that rbd-fuse doesn't recognize are getting yeeted on over to libfuse. it doesn't complain, it just hands them off. teamwork 🫢

  • -c ceph.conf β€” use the ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to figure out monitor addresses during startup. so if your conf lives literally anywhere else, this is your girl πŸ’œ
  • -p pool β€” use pool as the pool to search for rbd images. the default is rbd. πŸ“

🌈 AVAILABILITY 🌈

rbd-fuse is part of Ceph β€” a massively scalable, open-source, distributed storage system. if you wanna know more (and honestly, slay, go read up), please refer to the Ceph documentation at https://docs.ceph.com. πŸ“š


πŸ‘€ SEE ALSO πŸ‘€

  • fusermount(8)
  • rbd <>(8)

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0). πŸ’–


and that's a wrap, bestie!! this page came from the dev source, dated Oct 06, 2026 β€” go mount something cute, and remember: not for production, fr fr πŸ™…β€β™€οΈβœ¨πŸŒΈ

πŸ“¦ where this page comes from