jungledisk - Jungle Disk Desktop Command Line Interface
jungledisk mountpoint [options]
jungledisk command-line-only daemon was designed for headless servers
and/or for use in fstab and cron jobs. jungledisk supports file
system mounting via FUSE, as well as automatic backup.
** Important **
Please note that Jungle Disk Desktop CLI does not support Backup Vaults or Sync
-h/--help print this help
-v/--version print version
-d enable debugging
-V/--verbose verbose mode (only valid with -f)
-b/--startbackups start all backup jobs
-f run in foreground (default is daemon)
--startbackup <name|guid> start a single backup job
--listbackups list all configured backups
--listbuckets/--listonlinedisks list all configured buckets
-x/--exit exit when idle for 1 minute
--exitdelay <minutes> exit after X idle minutes
--config <filename> use the specified configuration file
-o opt[,opt...] additional FUSE mount options
jungledisk does not provide a configuration interface and must be
provided with a valid configuration file. We do not recommend creating
your configuration by hand. Instead, use junglediskmonitor on another
machine with a GUI, and copy the config file to your server.
If you do not have a Linux Desktop machine available, you can
use the "USB" version of the Mac or Windows Jungle Disk Client to
create a configuration file to use on your server. You cannot use
a configuration file from the non-USB versions on Mac or Windows,
as they encrypt their settings in a way that is not readable on Linux.
The configuration file can be placed in $HOME/.jungledisk, or in
/etc or another path, and you can specify the path to the file on
the command line.
Although less reliable than FUSE, you can also access the disk
via any WebDAV client: http://localhost:2667
The WebDAV interface to Jungle Disk is optional with the command
line version. You can disable it by setting the ListenPort to 0 in
If you have the WebDAV server enabled, you can view any background
operations by loading: http://localhost:2667/~operations via a
web browser or curl.
You can mount your filesystem via the fstab file by adding a line
such as the one below (note how the path to the config file is
specified as part of the FUSE options.)
Sample fstab file entry:
jungledisk /mnt/jungle \\
fuse noauto,config=/path/to/jungledisk-settings.xml 0 0
You can then mount your filesystem with "mount /mnt/jungle", or place
this command somewhere in your boot process to mount the filesystem
at boot time (after the network comes up).
Note: jungledisk will mount all of your online disks that have been
configured with mount points. The first mount point will be set to
the one specified in fstab, but the remaining network drives will
be mounted as found in your settings file.
jungledisk MUST be in your path to mount via fstab. Also, you
must ensure that the FUSE module is loaded on boot. This varies by
distribution. Some common ones:
Debian / Ubuntu:
$ echo "fuse" >> /etc/modules
$ echo "fuse" >> /etc/modules.autoload.d/kernel-2.6
$ echo "/sbin/modprobe fuse" >> /etc/rc.local
Edit /etc/sysconfig/kernel and add "fuse" to the MODULES_LOADED_ON_BOOT
By default the mounted path will only be available to the user who
If you want to allow root or other users to access the mount you
need to use the FUSE options "-o allow_root" or "-o allow_other". You
may also need to set the umask, as in "-o umask=007".
These parameters can be specified in fstab or on the command line:
jungledisk /mnt/mountpoint fuse defaults,noauto,user, \\
config=/path/to/jungledisk-settings.xml,allow_other,umask=007 0 0
$ jungledisk /mnt/mountpoint \\
Alternatively, you can configure FUSE options in the configuration
file after the mountpoint path (similar to the way it is done on the
command line). This approach is particularly useful when mounting
multiple disks, since only the first disk will pick up the extra
FUSE options specified on the command line or in fstab.
To allow the options to work for non-root users, be sure to add
the option "user_allow_other" to your /etc/fuse.conf file.
Once running and mounted on the local file system, you can use rsync
to easily copy files to and from your S3 storage. Most rsync options
should work fine, however for best performance we recommend using
the --inplace option which avoids extra renames.
You should also use the --times (-t) option so that modification
times are replicated and used to detect changes. If you prefer not
to replicate modification times, you may want to use --checksum (-c)
or --size-only to prevent files from being re-copied on every run.
Jungle Disk can preserve symlinks, devices, group/owner/permissions,
and modification/creation times if those options are
specified. Currently, hard-links are not supported.
Copy all files and attributes(times/permissions/owners/links/etc)
$ rsync -a --inplace /src/* /mnt/jungle
Copy only normal files and preserve modification times
$ rsync -t -r --inplace /src/* /mnt/jungle
Copy only file data and use size to determine changes
$ rsync -r --size-only --inplace /src/* /mnt/jungle
Sample jungledisk command line arguments:
$ jungledisk -df --config /etc/jungledisk-settings.xml
$ jungledisk /mnt/cloudstorage --config /etc/settings.xml
$ jungledisk -o allow_other
jungledisk logs all errors to /var/log/jungledisk.log when running
as root, and ~/.jungledisk/jungledisk.log when running as non-root.
Make sure you check the log file if your disk does not mount properly.
Jungle Disk includes several optimizations to improve performance
by delaying network activity until needed. In most cases this is
transparent to applications.
By default, Jungle Disk also assumes that when an application opens
a file using the O_WRONLY mode it intends to write the entire file,
so the previous file contents are not downloaded. This assumption
holds true for many, but not all applications.
The following signals are supported by Jungledisk:
SIGHUP Reload configuration
SIGQUIT Exits gracefully
Manual written by Erik Southworth; referenced from usage and INSTALL file.
Copyright (c) 2010 Jungle Disk, LLC. This is non-free software:
see the LICENSE file included with the software for copying conditions.
Copyright (c) 2010 Erik Southworth This is free documentation:
copying and distribution of this manual, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
Support Site http://support.jungledisk.com
FUSE Filesystem http://fuse.sourceforge.net
See also the INSTALL file for some useful tips and tricks.