Skip to main content

Mount JuiceFS at Boot

This is a guide about how to mount JuiceFS automatically at boot.


Copy juicefs as /sbin/mount.juicefs, then edit /etc/fstab with following line:

<META-URL>    <MOUNTPOINT>       juicefs     _netdev[,<MOUNT-OPTIONS>]     0  0

The format of <META-URL> is redis://<user>:<password>@<host>:<port>/<db>, e.g. redis://localhost:6379/1. And replace <MOUNTPOINT> with specific path you wanna mount JuiceFS to, e.g. /jfs. If you need set mount options, replace [,<MOUNT-OPTIONS>] with comma separated options list. The following line is an example:

redis://localhost:6379/1    /jfs       juicefs     _netdev,max-uploads=50,writeback,cache-size=2048     0  0

Note: By default, CentOS 6 will NOT mount network file system after boot, run following command to enable it:

$ sudo chkconfig --add netfs


Create a file named io.juicefs.<NAME>.plist under ~/Library/LaunchAgents. Replace <NAME> with JuiceFS volume name. Add following contents to the file (again, replace NAME, PATH-TO-JUICEFS, META-URL and MOUNTPOINT with appropriate value):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "">
<plist version="1.0">

Use following commands to load the file created in the previous step and test whether the loading is successful. Please ensure Redis server is already running.

$ launchctl load ~/Library/LaunchAgents/io.juicefs.<NAME>.plist
$ launchctl start ~/Library/LaunchAgents/io.juicefs.<NAME>

If mount failed, you can add following configuration to io.juicefs.<NAME>.plist file for debug purpose:


Use following commands to reload the latest configuration and inspect the output:

$ launchctl unload ~/Library/LaunchAgents/io.juicefs.<NAME>.plist
$ launchctl load ~/Library/LaunchAgents/io.juicefs.<NAME>.plist
$ cat /tmp/juicefs.out
$ cat /tmp/juicefs.err

If you install Redis server by Homebrew, you could use following command to start it at boot:

$ brew services start redis

Then add following configuration to io.juicefs.<NAME>.plist file for ensure Redis server is loaded: