GANESHA-RGW-CONFIG(8)

πŸ’– GANESHA-RGW-CONFIG β€” the NFS Ganesha RGW config file, explained by your fave πŸ’–

okay bestie, sit down, hydrate, because we're talking about ganesha-rgw-config, aka the NFS Ganesha RGW Configuration File 🌸 and it's genuinely not that deep once you see it laid out.


✨ SYNOPSIS ✨

/etc/ganesha/rgw.conf

/etc/ganesha/rgw_bucket.conf

that's it. two files. two icons. πŸ’…


🌈 DESCRIPTION 🌈

so NFS-Ganesha ships two example configs for the RGW FSAL, and they're literally right here:

  • /etc/ganesha/rgw.conf
  • /etc/ganesha/rgw_bucket.conf

and the page you're reading? it's the one that lists all the RGW specific config options. the RGW lore, if you will. πŸ“–βœ¨


πŸ¦‹ EXPORT { } πŸ¦‹

real talk: RGW can export both the buckets and the filesystem. both. at the same time. main character behavior honestly πŸ‘‘


πŸŽ€ EXPORT { FSAL {} } πŸŽ€

⭐ Name(string, "RGW")

the Name of the FSAL should always be RGW. like, always always. no cap.

πŸ’œ User_Id(string, no default)

no default, bestie. you're bringing your own.

πŸ”₯ Access_Key(string, no default)

again β€” no default. you supply it.

πŸ’€ Secret_Access_Key(string, no default)

and yeah, no default here either. it's giving "bring your own credentials" energy πŸ™ˆ


πŸ‘‘ RGW {} πŸ‘‘

these next config variables are the ones that customize the startup of the FSAL's radosgw instance. so if you wanna tweak how that thing wakes up in the morning, this is the section. β˜•βœ¨

  • ceph_conf β€” optional full-path to the Ceph configuration file. it's the equivalent of passing "-c /path/to/ceph.conf" to any Ceph binary.
  • name β€” optional instance name. equivalent to passing "--name client.rgw.foohost" to the radosgw binary. heads up though: the value you put here should be the same as the section name (sans brackets) of the radosgw facility in the Ceph configuration file β€” and that section must exist. so like, no vibes-based naming here, it has to match fr fr.
  • cluster β€” optional cluster name. equivalent to passing "--cluster foo" to any Ceph binary. using a non-default value for cluster name is uncommon, but you can verify it by examining the startup options of Ceph binaries. iykyk.
  • init_args β€” additional argument strings that get passed verbatim to the radosgw instance startup process, exactly as if they'd been given on the radosgw command line. this one's provided for customization in uncommon setups, so it's the "only if you know why you're here" option 🫢

πŸ’« SEE ALSO πŸ’«

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

go read those next, they're also slay ⭐


and that's the whole page, bestie πŸŽ€ this was NFS-Ganesha, dated Aug 11, 2026 β€” GANESHA-RGW-CONFIG(8), signing off. periodt. πŸ’–βœ¨

πŸ“¦ where this page comes from