CEPH-FUSE(8)

📦
version 20.2.4 · 20 versions
, in ubuntu stonking

💅 CEPH-FUSE — the ceph-fuse(8) page, but make it a group chat

okay so bestie, you know how we're always like "the filesystem is Right There but it's not on my laptop"? yeah. this is ceph-fuse, from the Ceph manual, and it's literally the glow-up that puts your Ceph file system into your userspace. sit down, hydrate, let's go 🦋

✨ NAME ✨

ceph-fuse — a FUSE-based client for ceph. that's it, that's the whole vibe. it's the little guy that makes your filesystem show up where you actually need it 💖

🌸 SYNOPSIS 🌸

ceph-fuse [-n client.username] [ -m monaddr:port ] mountpoint [ fuse options ]

like — mountpoint, a couple of flags if you're feeling spicy, and whatever fuse options you wanna hand over. slay ✨

🎀 DESCRIPTION 🎀

So. ceph-fuse is a FUSE client — and FUSE stands for "Filesystem in USErspace", which is iconic naming actually — for the Ceph distributed file system. It will mount a ceph file system that you specified via the -m option, or one that's described by ceph.conf (more on that below), right at the mount point you picked. Simple. Elegant. Chef's kiss 👑

If you want the detailed lore, the page sends you to Mount CephFS using FUSE <../../../cephfs/mount-using-fuse/>. go read, bestie, it's giving tutorial 💅

🧹 How to unmount (because you can't just ghost it)

You can unmount the file system with:

fusermount -u mountpoint

or by sending SIGINT to the ceph-fuse process. two options, both valid, pick your fighter 😭

👑 OPTIONS 👑

Quick heads-up before the list: any options that ceph-fuse doesn't recognize get passed straight on to libfuse. so if you brought your own flag, it's not getting ignored, it's getting re-gifted 🎀

  • -o opt,[opt...] — Mount options. the classic "here's a comma salad of stuff, handle it" move.
  • -c ceph.conf, --conf=ceph.conf — use ceph.conf as the configuration file instead of the default /etc/ceph/ceph.conf, specifically to figure out the monitor addresses while starting up. fr fr, this is your "my config is not in the normal spot" flag.
  • -m monaddress[:port] — connect to the monitor you specify (instead of digging through ceph.conf looking for one). port is optional, she's flexible ✨
  • -n client.{cephx-username} — pass in the name of the CephX user whose secret key is gonna be used for mounting. yes, the placeholder is literally {cephx-username}, keep the braces, don't @ me.
  • --id <client-id> — same energy as -n: pass the name of the CephX user whose secret key is to be used for mounting. the difference? --id takes just the ID of the client, in contrast to -n. like, for example, --id 0 means you're using client.0. periodt 💅
  • -k <path-to-keyring> — hands you the path to the keyring. useful when it's absent from the standard locations, which is... a mood 🙈
  • --client_mountpoint / -r root_directory — use root_directory as the mounted root, instead of the whole entire Ceph tree. like, you can just take a slice 🍓
  • -f — Foreground: do not daemonize after startup, i.e. run in the foreground. and also — do not generate a pid file. no pid file, no drama.
  • -d — run in the foreground, send all log output to stderr, and turn on FUSE debugging (that's -o debug). she's loud and she's proud, and honestly? valid.
  • -s — Disable multi-threaded operation. single-threaded era, for the girlies who want one thing happening at a time 🧚
  • --client_fs — pass the name of the Ceph FS to be mounted. if you don't pass this option, you get the default Ceph FS on the Ceph cluster. so like, no flag = default behavior, no cap.

🌈 AVAILABILITY 🌈

ceph-fuse is part of Ceph, a massively scalable, open-source, distributed storage system. (say that five times fast, I dare you 😭) Please refer to the Ceph documentation at <https://docs.ceph.com> for more information. literally the source of truth, bookmark her.

🔥 SEE ALSO 🔥

  • fusermount(8)
  • ceph <>(8)

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

okay that's the whole page bestie, you're officially certified 💅 and for the cute lil sign-off — this one's from the dev manual, dated Oct 06, 2026, stamped CEPH-FUSE(8) at the bottom. go mount something iconic 🫶✨

📦 where this page comes from