CEPH-FUSE(8) Ceph CEPH-FUSE(8)

# [NAME](#NAME)

ceph-fuse - FUSE-based client for ceph

# [SYNOPSIS](#SYNOPSIS)

```
ceph-fuse [-n client.username] [ -m monaddr:port ] mountpoint [ fuse options ]
```

# [DESCRIPTION](#DESCRIPTION)

**ceph-fuse** is a FUSE ("Filesystem in USErspace") client for Ceph distributed file system. It will mount a ceph file system specified via the -m option or described by ceph.conf (see below) at the specific mount point. See Mount CephFS using FUSE <../../../cephfs/mount-using-fuse/> for detailed information.

The file system can be unmounted with:

```
fusermount -u mountpoint
```

or by sending **SIGINT** to the **ceph-fuse** process.

# [OPTIONS](#OPTIONS)

Any options not recognized by ceph-fuse will be passed on to libfuse.

[**-o opt,\[opt...\]**](#o)

Mount options.

[**-c ceph.conf, --conf=ceph.conf**](#c)

Use *ceph.conf* configuration file instead of the default **/etc/ceph/ceph.conf** to determine monitor addresses during startup.

[**-m monaddress\[:port\]**](#m)

Connect to specified monitor (instead of looking through ceph.conf).

[**-n client.{cephx-username}**](#n)

Pass the name of CephX user whose secret key is be to used for mounting.

[**--id <client-id>**](#id)

Pass the name of CephX user whose secret key is be to used for mounting. **--id** takes just the ID of the client in contrast to **-n**. For example, **--id 0** for using **client.0**.

[**-k <path-to-keyring>**](#k)

Provide path to keyring; useful when it's absent in standard locations.

[**--client\_mountpoint/-r root\_directory**](#client_mountpoint/)

Use root\_directory as the mounted root, rather than the full Ceph tree.

[**-f**](#f)

Foreground: do not daemonize after startup (run in foreground). Do not generate a pid file.

[**-d**](#d)

Run in foreground, send all log output to stderr and enable FUSE debugging (-o debug).

[**-s**](#s)

Disable multi-threaded operation.

[**--client\_fs**](#client_fs)

Pass the name of Ceph FS to be mounted. Not passing this option mounts the default Ceph FS on the Ceph cluster.

# [AVAILABILITY](#AVAILABILITY)

**ceph-fuse** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at <https://docs.ceph.com> for more information.

# [SEE ALSO](#SEE_ALSO)

[fusermount(8)](/man/enterprise-packages/ceph-19/fusermount.8), ceph <>(8)

# [Copyright](#Copyright)

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

October 16, 2026 dev

---

Document: ceph-fuse(8) from ceph-19 19.2.7-r3 (Chainguard OS)
Source: https://github.com/ceph/ceph.git