GANESHA-CEPH-CONFIG(8)

💖 ganesha-ceph-config — NFS Ganesha CEPH Configuration File 💖

okay so this is the GANESHA-CEPH-CONFIG(8) page bestie, and we're about to make the Ceph config file make so much sense 🧚✨ it's giving "your NFS-Ganesha install config example for CEPH FSAL" energy:

NFS-Ganesha install config example for CEPH FSAL: |
/etc/ganesha/ceph.conf

---

🌸 SYNOPSIS 🌸

/etc/ganesha/ceph.conf

---

🎀 DESCRIPTION 🎀

so basically /etc/ganesha/ceph.conf is the file, and it's where all the Ceph-specific config options live 💅 this file lists CEPH specific config options. that's the vibe. periodt.

🦋 EXPORT { FSAL {} } 🦋

these are the options that live inside EXPORT { FSAL {} }, iykyk:

• Name — string, "Ceph". the name of the FSAL, and it should always be Ceph. like, always always. no cap.
• Filesystem — string, no default. the Ceph filesystem name string, for mounting an alternate filesystem within the cluster 🫶 the default is to mount the default filesystem in the cluster (usually, the first one created).
• User_Id — string, no default. the cephx userid used to open the MDS session. this string is literally what gets appended to "client." 💫 if it's not set, the ceph client libs will sort this out based on ceph configuration. they got it, bestie.
• Secret_Access_Key — string, no default. the key to use for the session (if any) 🔑 if it's not set, then it uses the normal search path for cephx keyring files to find a key.
• sec_label_xattr — char, default "security.selinux xattr of the file". enables the NFSv4.2 security label attribute ✨ Ganesha supports "Limited Server Mode" as detailed in RFC 7204. note that not all FSALs support security labels, so don't come for me if yours doesn't 🙈
• cmount_path — string, no default. if specified, it's the path within the ceph filesystem to mount this export on 🌈 it is allowed to be any complete path hierarchy between / and the EXPORT {path}. (i.e. if EXPORT { Path } parameter is /foo/bar then cmount_path could be /, /foo or /foo/bar).

and ooh, this part is lowkey iconic: if this and the other EXPORT { FSAL {} } options are the same between multiple exports, those exports will share a single cephfs client 👯 with the default, this effectively defaults to the same path as EXPORT { Path }.

🌟 CEPH {} 🌟

and these cuties go in the CEPH {} block:

• Ceph_Conf — path, default "". path to the ceph config file to inherit ceph configuration from 📁
• umask — mode, range 0 to 0777, default 0. that's it, that's the entry 💀 no extra notes, we move.
• client_oc — bool, default false. enable or disable client_oc (object cache) 🧺 this defaults to false because Ganesha runs better with it disabled. trust.
• async — bool, default false. enable ceph async operations (read and write) ⚡
• zerocopy — bool, default false. enable ceph zero copy I/O ✨ heads up though: zero copy and client_oc are incompatible — pick a lane, bestie 🚫
• use_old_uuid — bool, default false. use old uuid logic for the ceph client 👑 useful when upgrading from a pre 7.0 version to latest. if this flag is set, then continue using it. as per old logic the uuid is formed as "ganesha-<nodeid>-<export-id>". as per new logic the uuid is formed as "ganesha-<64-bytes-hash>", and the hash is formed using nodeid, userid, fs_name and mount path.

for fresh deployments of 7.0 and later versions, do not set this parameter 🙅‍♀️ like, don't.

• register_service — bool, default false. enable registration of the NFS service with the Ceph cluster 🔥 this allows Ceph to track the NFS service for health monitoring and service discovery.
• nodeid — string, default "". identifier used when registering this NFS instance with Ceph 🏷️ this value must be unique per NFS node within the same Ceph cluster. required only when register_service is set to true.

---

💜 SEE ALSO 💜

go read these next, they're the whole friend group fr fr:

• ganesha-config <>(8)
• ganesha-log-config <>(8)
• ganesha-core-config <>(8)
• ganesha-export-config <>(8)

---

okay that's the whole page bestie, you ate that 💅 this was NFS-Ganesha, dated Aug 11, 2026 🎀 go forth and mount responsibly, mwah 🫶💖