This document is for a development version of Ceph.

mount.fuse.ceph -- mount ceph-fuse from /etc/fstab.


mount.fuse.ceph [-h] [-o OPTIONS [OPTIONS …]] device [device …] mountpoint [mountpoint …]


mount.fuse.ceph is a helper for mounting ceph-fuse from /etc/fstab.

To use mount.fuse.ceph, add an entry in /etc/fstab like:

none      /mnt/ceph   fuse.ceph,_netdev,defaults  0 0
none      /mnt/ceph   fuse.ceph,_netdev,defaults  0 0
none      /mnt/ceph   fuse.ceph,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults  0 0

ceph-fuse options are specified in the OPTIONS column and must begin with ‘ceph.’ prefix. This way ceph related fs options will be passed to ceph-fuse and others will be ignored by ceph-fuse.


Specify that the ceph-fuse will authenticate as the given user.

Specify that the ceph-fuse will authenticate as client.admin


Sets ‘conf’ option to /etc/ceph/foo.conf via ceph-fuse command line.

Any valid ceph-fuse options can be passed this way.

Additional Info

The old format /etc/fstab entries are also supported:

DEVICE                              PATH        TYPE        OPTIONS
id=admin                            /mnt/ceph   fuse.ceph   defaults   0 0
id=myuser,conf=/etc/ceph/foo.conf   /mnt/ceph   fuse.ceph   defaults   0 0


mount.fuse.ceph is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at for more information.

See also

ceph-fuse(8), ceph(8)

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.