JuiceFS provides several access methods, FUSE is the common one, which is the way to mount the filesystem locally using the
juicefs mount command. Users can add FUSE mount options for more granular control.
This guide describes the common FUSE mount options for JuiceFS, with two ways to add mount options:
- Manually execute
juicefs mountcommand, specified by the
-ooption, with multiple options separated by commas.
juicefs mount -d -o allow_other,writeback_cache sqlite3://myjfs.db ~/jfs
- Linux distributions define automounting via
/etc/fstabby adding options directly to the
optionsfield, with multiple options separated by commas.
# <file system> <mount point> <type> <options> <dump> <pass>
redis://localhost:6379/1 /jfs juicefs _netdev,allow_other 0 0
This option is automatically enabled when JuiceFS is mounted and does not need to be explicitly specified. It will enable the kernel's file access checks, which are performed outside the filesystem. When enabled, both the kernel checks and the filesystem checks must succeed before further operations.
The kernel performs standard UNIX permission checks based on mode bits, uid/gid, and directory entry ownership.
By default, only the user who mounted the filesystem can access the files. The
allow_other option allows other users (including the root user) to access the files as well.
By default, this option is only available to the root user, but can be unrestricted by modifying
/etc/fuse.conf and turning on the
user_allow_other configuration option.
This mount option requires at least version 3.15 Linux kernel
FUSE supports "writeback-cache mode", which means the
write() syscall can often complete rapidly. It's recommended to enable this mount option when write small data (e.g. 100 bytes) frequently.
user_id and group_id
These two options are used to specify the owner ID and owner group ID of the mount point, but only allow to execute the mount command as root, e.g.
sudo juicefs mount -o user_id=100,group_id=100.
This option will output Debug information from the low-level library (go-fuse) to
This option will output debug information for the low-level library (go-fuse) to
juicefs.log. Note that this option is different from the global
-debug option for the JuiceFS client, where the former outputs debug information for the go-fuse library and the latter outputs debug information for the JucieFS client. see the documentation Fault Diagnosis and Analysis.