---
name: "mount.glusterfs"
section: "8"
platform: "linux"
package: "glusterfs"
version: "1:11.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mount.glusterfs"
---

# mount.glusterfs(8)

script to mount native GlusterFS volume

## NAME

**mount.glusterfs - script to mount native GlusterFS volume**

## SYNOPSIS

**mount -t glusterfs \[-o \<options\>\] \<volumeserver\>:/\<volume\>\[/\<subdir\>\]** **\<mountpoint\>**

- **mount -t glusterfs \[-o \<options\>\] \<server1\>,\<server2\>,**

  **\<server3\>,..\<serverN\>:/\<volname\>\[/\<subdir\>\] \<mount\_point\>**

-

  - **mount -t glusterfs \[-o \<options\>\] \<path/to/volumefile\> \<mountpoint\>**

  ## DESCRIPTION

This tool is part of [**glusterfs**(8)](/glusterfs/8.md) package, which is used to mount using GlusterFS native binary.

**mount.glusterfs** is meant to be used by the [mount(8)](/mount/8.md) command for mounting native GlusterFS client. This subcommand, however, can also be used as a standalone command with limited functionality.

## OPTIONS

### Basic options

- **log-file=**LOG-FILE

  File to use for logging \[default:/var/log/glusterfs/glusterfs.log\]

- **log-level=**LOG-LEVEL

  Logging severity.  Valid options are TRACE, DEBUG, WARNING, ERROR, CRITICAL INFO and NONE \[default: INFO\]

- **acl**

  **Mount the filesystem with POSIX ACL support**

- **fopen-keep-cache\[=BOOL\]**

  **Do not purge the cache on file open (default: false)**

- **worm**

  **Mount the filesystem in 'worm' mode**

- **aux-gfid-mount**

  **Enable access to filesystem through gfid directly**

- **ro**

  Mount the filesystem read-only

- **enable-ino32=**BOOL

  Use 32-bit inodes when mounting to workaround broken applications that don't support 64-bit inodes

- **mem-accounting**

  **Enable internal memory accounting**

- **capability**

  **Enable file capability setting and retrival**

- **thin-client**

  **Enables thin mount and connects via gfproxyd daemon**

- **localtime-logging**

  **Use local timestamps instead of UTC in mount log entries**

### Advanced options

- **attribute-timeout=**SECONDS

  Set attribute timeout to SECONDS for inodes in fuse kernel module \[default: 1\]

- **entry-timeout=**SECONDS

  Set entry timeout to SECONDS in fuse kernel module \[default: 1\]

- **background-qlen=**N

  Set fuse module's background queue length to N \[default: 64\]

- **gid-timeout=**SECONDS

  Set auxiliary group list timeout to SECONDS for fuse translator \[default: 0\]

- **negative-timeout=**SECONDS

  Set negative timeout to SECONDS in fuse kernel module \[default: 0\]

- **volume-name=**VOLUME-NAME

  Volume name to be used for MOUNT-POINT \[default: top most volume in VOLUME-FILE\]

- **direct-io-mode=**BOOL\|auto

  Specify fuse direct I/O strategy \[default: auto\]

- **congestion-threshold=**N

  Set fuse module's congestion threshold to N \[default: 48\]

- ubdir-mount=N

  Set the subdirectory mount option \[default: NULL, ie, no subdirectory mount\]

-

  - **backup-volfile-servers=**SERVERLIST

  Provide list of backup volfile servers in the following format \[default: None\] If use IPv6 address in SERVERLIST, it is required to use '\[' and '\]' to surround IPv6 address.

  **$ mount -t glusterfs -obackup-volfile-servers=\<server2\>:**        **\<server3\>:...:\<serverN\> \<server1\>:/\<volname\> \<mount\_point\>** **$ mount -t glusterfs -obackup-volfile-servers=\<\[ipv6\_addr2\]\>:**        **\<\[ipv6\_addr3\]\>:...:\<\[ipv6\_addrN\]\> \<ipv6\_addr1\>:/\<volname\> \<mount\_point\>**

-

  - **backupvolfile-server=**SERVER

  Provide list of backup volfile servers in the following format \[default: None\]

   **$ mount -t glusterfs -obackupvolfile-server=\<server2\>**          **\<server1\>:/\<volname\> \<mount\_point\>**

-

  - **fetch-attempts=**N

  **Deprecated** option - placed here for backward compatibility \[default: 1\]

-

  - **lru-limit=**N

  Set fuse module's limit for number of inodes kept in LRU list to N \[default: 65536\]

-

  - **inode-table-size=**N

  Set the inode hash table size to N - this must be a power of 2 greater than or equal to 65536 and will be rounded up if not \[default: 65536\]

-

  - **invalidate-limit=**N

  Suspend fuse invalidations implied by 'lru-limit' if  number of outstanding invalidations reaches N

-

  - **background-qlen=**N

  Set fuse module's background queue length to N \[default: 64\]

- **no-root-squash=**BOOL

  disable root squashing for the trusted client \[default: off\]

- **root-squash=**BOOL

  enable root squashing for the trusted client \[default: on\]

- **use-readdirp=**BOOL

  Use readdirp() mode in fuse kernel module \[default: on\]

- **dump-fuse=**PATH

  Dump fuse traffic to PATH

- **kernel-writeback-cache=**BOOL

  Enable fuse in-kernel writeback cache \[default: off\]

- **attr-times-granularity=**NS

  Declare supported granularity of file attribute \[default: 0\]

- **auto-invalidation=**BOOL

  controls whether fuse-kernel can auto-invalidate attribute, dentry and page-cache. Disable this only if same files/directories are not accessed across two different mounts concurrently \[default: on\]

## FILES

- */etc/fstab*

  A typical GlusterFS entry in /etc/fstab looks like below

  **server1:/mirror  /mnt/mirror  glusterfs log-file=/var/log/mirror.log,acl   0  0**

- */proc/mounts*

  An example entry of a GlusterFS mountpoint in /proc/mounts looks like below

  **server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow\_other,default\_permissions,max\_read=131072 0 0**

## SEE ALSO

[**glusterfs**(8)](/glusterfs/8.md), [**mount**(8)](/mount/8.md), [**gluster**(8)](/gluster/8.md)

## COPYRIGHT

Copyright(c) 2006-2013   Red Hat, Inc.   \<http://www.redhat.com\>