This document is for a development version of Ceph.


CephFS namespaces can be exported over NFS protocol using the NFS-Ganesha NFS server. This document provides information on configuring NFS-Ganesha clusters manually. The simplest and preferred way of managing NFS-Ganesha clusters and CephFS exports is using ceph nfs ... commands. See CephFS & RGW Exports over NFS for more details. As the deployment is done using cephadm or rook.


  • Ceph file system

  • libcephfs2, nfs-ganesha and nfs-ganesha-ceph packages on NFS server host machine.

  • NFS-Ganesha server host connected to the Ceph public network


It is recommended to use 3.5 or later stable version of NFS-Ganesha packages with pacific (16.2.x) or later stable version of Ceph packages.

Configuring NFS-Ganesha to export CephFS

NFS-Ganesha provides a File System Abstraction Layer (FSAL) to plug in different storage backends. FSAL_CEPH is the plugin FSAL for CephFS. For each NFS-Ganesha export, FSAL_CEPH uses a libcephfs client to mount the CephFS path that NFS-Ganesha exports.

Setting up NFS-Ganesha with CephFS, involves setting up NFS-Ganesha’s and Ceph’s configuration file and CephX access credentials for the Ceph clients created by NFS-Ganesha to access CephFS.

NFS-Ganesha configuration

Here’s a sample ganesha.conf configured with FSAL_CEPH. It is suitable for a standalone NFS-Ganesha server, or an active/passive configuration of NFS-Ganesha servers, to be managed by some sort of clustering software (e.g., Pacemaker). Important details about the options are added as comments in the sample conf. There are options to do the following:

  • minimize Ganesha caching wherever possible since the libcephfs clients (of FSAL_CEPH) also cache aggressively

  • read from Ganesha config files stored in RADOS objects

  • store client recovery data in RADOS OMAP key-value interface

  • mandate NFSv4.1+ access

  • enable read delegations (need at least v13.0.1 libcephfs2 package and v2.6.0 stable nfs-ganesha and nfs-ganesha-ceph packages)


Under certain conditions, NFS access using the CephFS FSAL fails. This causes an error to be thrown that reads “Input/output error”. Under these circumstances, the application metadata must be set for the CephFS metadata and data pools. Do this by running the following command:

ceph osd pool application set <cephfs_metadata_pool> cephfs <cephfs_data_pool> cephfs

Configuration for libcephfs clients

ceph.conf for libcephfs clients includes a [client] section with mon_host option set to let the clients connect to the Ceph cluster’s monitors, usually generated via ceph config generate-minimal-conf. For example:

        mon host = [v2:,v1:], [v2:,v1:], [v2:,v1:]

Mount using NFSv4 clients

It is preferred to mount the NFS-Ganesha exports using NFSv4.1+ protocols to get the benefit of sessions.

Conventions for mounting NFS resources are platform-specific. The following conventions work on Linux and some Unix platforms:

mount -t nfs -o nfsvers=4.1,proto=tcp <ganesha-host-name>:<ganesha-pseudo-path> <mount-point>

Brought to you by the Ceph Foundation

The Ceph Documentation is a community resource funded and hosted by the non-profit Ceph Foundation. If you would like to support this and our other efforts, please consider joining now.