OS Manuals

/usr/bin/mount.fuse.ceph

Common utilities to mount and interact with a Ceph storage cluster

From ceph-19-common 19.2.7-r4 (enterprise-packages), captured 2026-11-08 by running mount.fuse.ceph --help (exit 0). permalink

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

Helper to mount ceph-fuse from /etc/fstab.  To use, add an entry
like:

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

ceph-fuse options are specified in the fs_mntops(4) 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.

The first two examples above specify that ceph-fuse will authenticate
as client.admin. The third example specify that ceph-fuse will authenticate as
client.myuser and also sets 'conf' option to '/etc/ceph/foo.conf' via ceph-fuse
command line. Any valid ceph-fuse options can be passed this way.

NOTE:
Old format is 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

positional arguments:
  device                Device
  mountpoint            Mount point

options:
  -h, --help            show this help message and exit
  -o OPTIONS [OPTIONS ...]
                        Filesystem options
Options (1)
OptionDescriptionSource
-h, --helpshow this help message and exithelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.