GANESHA-PROXY-V3-CONFIG(8)

💖 GANESHA-PROXY-V3-CONFIG 💖 (section 8, bestie)

okay so real quick — this is the manual page for ganesha-proxy-v3-config, aka the NFSv3 Ganesha Proxy Configuration File. yes it's a mouthful. yes it's important. let's go 💅

---

✨ NAME ✨

ganesha-proxy-v3-config — the NFSv3 Ganesha Proxy Configuration File. that's the whole vibe. she configures. she proxies. she serves. 🦋

---

✨ SYNOPSIS ✨

/etc/ganesha/ganesha.conf

---

✨ DESCRIPTION ✨

so NFS-Ganesha installs this config file for the Proxy FSAL, and it lives right here, no cap:

/etc/ganesha/ganesha.conf

this file is where all the Proxy-specific config options hang out. it's giving very "one file to rule them all." 👑

---

🌸 EXPORT { FSAL {} } 🌸

this is the block where you tell Ganesha which FSAL you're running. the options inside are:

• Name (string, default "proxy_v3") — the name of the FSAL. bestie, this should always be proxy_v3. don't try to be creative here, it will not slay. 🙈
• Srv_Addr (ipv4_addr, default "127.0.0.1") — the server address. defaults to localhost, classic.
• FSAL_MAXIOSIZE (default 64 MB) — the max I/O size for the FSAL. sixty-four megabytes of pure potential. 🔥

---

🎀 PROXY_V3 {} 🎀

this is the main character block, the one you're actually here for. inside PROXY_V3 {} you got:

• FSAL_MAXIOSIZE (default 64 MB) — same deal as above, the maximum I/O size. ✨
• maxread (uint64, default 1 MB) — the maximum read size. its range is 1024 to FSAL_MAXIOSIZE.

heads up bestie: this value will get clamped to the backend's FSINFO response. so like, you can ask for the moon, but the backend's FSINFO is the vibe check and it decides. 🌙

• maxwrite (uint64, default 1 MB) — the maximum write size. range is 1024 to FSAL_MAXIOSIZE.

same warning as maxread, fr fr: this value will get clamped to the backend's FSINFO response. 🫶

• num_sockets (uint32, default 32) — how many sockets. range is 1 to 1000.

okay important: these sockets must be privileged ports, and those can be limited on a given system. it is unlikely that 1000 privileged ports are available. so like, don't just yeet it to 1000 and expect magic. it's giving delulu. 💀

• allow_lookup_optimization (bool, default true) — set this to false to disable the lookup optimization for the current working directory and the current working directory's parent from the cache. so if the caching of those two is bothering you, this is your girl. 🧚

---

✨ SEE ALSO ✨

go read these too, they're all iconic in their own right:

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

---

and that's the whole page, bestie. this version is from the NFS-Ganesha source, dated <b>Aug 11, 2026</b>, and it goes by <b>GANESHA-PROXY-V3-CONFIG(8)</b> — now go configure something and absolutely eat. 💅✨💖