VFS_GLUSTERFS_FUSE(8)

✨ VFS_GLUSTERFS_FUSE ✨

okay so bestie, welcome to vfs_glusterfs_fuse — section 8 of the system administration tools, and literally one of the most niche-but-iconic pages in the whole Samba lineup 💖

---

🌸 NAME 🌸

vfs_glusterfs_fuse — utilize features provided by GlusterFS 🦋

---

🎀 SYNOPSIS 🎀

vfs objects = glusterfs_fuse

that's it. that's the whole vibe. no cap.

---

💅 DESCRIPTION 💅

so first things first: this VFS module is part of the samba(8) suite. one of the family. part of the collective. 🫶

GlusterFS (http://www.gluster.org) is an Open Source clustered file system that can scale to several peta-bytes — yes bestie, peta. with its FUSE based native client, GlusterFS shows up as a POSIX compliant file system, which means Samba can share it with zero extra steps. iconic behaviour honestly.

the vfs_glusterfs_fuse VFS module gives you an enhanced way to access a Gluster filesystem through a Gluster FUSE mount. what does it bring to the group chat?

• it supports the get_real_filename VFS call, which makes file access faster by avoiding multiple expensive case folding lookup calls just to figure out the actual case of a filename that already exists. not me saving you all those lookups 😭
• it also implements a substitute file-id mechanism. and this part is important, so listen up: the default file-id mechanism does not work correctly for gluster fuse mount re-exports. so to avoid data loss, if you're exporting gluster fuse mounts with Samba, you should enable this module. fr fr. this is the whole reason it exists.

💀 lowkey a warning, highkey a requirement: exporting gluster fuse mounts without this module risks data loss. don't do that to yourself.

you can combine this module with others, but it should be the last module in the vfs objects list. modules you add to the right of the glusterfs entry may not have any effect at all. they're just there. standing in the corner. ignored. 🙈

---

🌈 CONFIGURATION 🌈

a basic configuration looks like this, bestie — copy it, love it, use it:

[share]
vfs objects = glusterfs_fuse
path = /absolute/path_of_fusemount

note that vfs_glusterfs_fuse requires a Gluster mount. if you wanna access glusterfs directly over the GFAPI library instead, you want the vfs_glusterfs module, not this one. different module, different vibe. 💜

---

🍓 OPTIONS 🍓

this module does currently have no further options.

that's it. that's the options section. nothing to configure, nothing to tune, it just works. the way that it needs literally zero options and still carries the whole team on its back 👑

---

⭐ VERSION ⭐

this man page is part of version 4.24.7 of the Samba suite.

---

👑 AUTHOR 👑

the original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project, similar to the way the Linux kernel is developed. main character energy from day one, honestly 🌟

---

Samba 4.24.7 · 09/09/2026 · VFS_GLUSTERFS_FUSE(8) — that's the source, the version, and the date bestie, mwah 💋 stay POSIX compliant, keep your vfs objects list in order, and never let a gluster fuse re-export go un-moduled. bye bestie 🦋✨