Volume Types
Volume types play an important role when handling your files.
When you unlock a vault, Cryptomator makes decrypted files available in your file manager by mounting a virtual drive on your operating system. This mounting of a virtual drive is handled differently depending on the volume type chosen in Cryptomator’s preferences.
In general, all volume types Cryptomator offers can be categorized into two categories:
What is a WebDAV volume type?
WebDAV is a standardized communication protocol used to perform operations on resources (files, directories/folders) between a client (you) and a server (your local computer). WebDAV was intended for remote access, but Cryptomator uses it to start a local-only server, which you can use to browse your decrypted files.
You can tweak WebDAV’s settings for each vault by navigating to Cryptomator Preferences -> Virtual Drive.
WebDAV has widespread support and adequate performance, but its implementation differs between operating systems.
What is a FUSE volume type?
Filesystem in Userspace (FUSE) is a filesystem interface originally developed for Unix operating systems that let non-privileged users create their own file systems without editing kernel code. Which means, FUSE does not require admin privileges and is has good support across all major desktop operating systems. FUSE volume type also delivers good performance when working on files.
All FUSE related volume types support custom mount options, but every option must be prefixed with -o
.
For example, you must enter -oallow_other
if you want to specify allow_other
option.
Choosing a Volume Type
Cryptomator uses the same volume type for all vaults. You can select which volume type to use in the preferences. Every volume type offers fixed set of features for mounting a vault. The feature set is shown when selecting the volume type.
In Cryptomator’s window, navigate to Preferences
(gear icon at top right), then Virtual Drive
to set the volume type.
The availability of volume types depends on your operating system and installed drivers.
You might have to restart Cryptomator when changing volume types.
A notification will be displayed if a restart is needed.
Windows
WinFsp / WinFsp (Local Drive)
Requirements: Windows, WinFsp installed
The WinFsp project provides FUSE bindings for Windows. WinFsp is automatically installed along Cryptomator when you are using the EXE installer, but there’s also a WinFsp standalone installer here if you ever need it.
By default, unlocked vaults are mounted to a random drive letter, either as a network or a local drive. Info on custom mount options is available at WinFsp repository.
Note
Vaults mounted to a drive letter are only accessible to the current user. If you want to access the vault as a different/elevated user, you have to use WinFsp (Local Drive) and mount to a directory.
WebDAV (Windows Explorer)
Requirements: Windows
WebDAV on Windows uses the net use command to mount/unmount the virtual drive. By default, unlocked vaults are mounted as a network drive and assigned a random drive letter. Using WebDAV on Windows has the following drawbacks:
The size of transferred files is restricted to a maximum of 4 GB.
The total space and free space of the network drive are shown to be the same as the total space and free space of the C: drive, which is technically incorrect.
macOS
macFUSE
Requirements: macOS, macFUSE installed
Warning
Apple has deprecated the OS APIs used by macFUSE since macOS 12.3 and made installation difficult. We recommend you to use FUSE-T and only fallback to macFUSE, if there are any errors.
macFUSE volume type depends on a library provided by the macFUSE project. It is not included with Cryptomator due to license restrictions. However, you can install the latest version from macFUSE’s release page.
By default, unlocked vaults are mounted to /Volumes. Info on custom mount options is available at macFUSE wiki.
FUSE-T (Experimental)
Requirements: macOS, FUSE-T installed
This volume type depends on a library provided by the new FUSE-T project. You can install it using brew:
brew tap macos-fuse-t/homebrew-cask
brew install fuse-t
By default, unlocked vaults are mounted to ~/Cryptomator/. Info on custom mount options is available at wiki of the FUSE-T project.
Note
FUSE-T is a new project, so support for it is currently marked as experimental. Be sure to keep FUSE-T up to date to benefit from the latest improvements.
WebDAV (AppleScript)
Requirements: macOS
WebDAV on macOS utilizes the scripting language AppleScript to mount/unmount the virtual drive. By default, unlocked vaults are mounted to /Volumes.
Linux based OS
FUSE
Requirements: Linux, fuse3
installed
FUSE on Linux works only if the fuse3 package is installed. Luckily, fuse3 comes pre-installed on many Linux distributions.
By default, unlocked vaults are mounted to ~/.local/share/Cryptomator/mnt, but you can use custom mount options to change the path. Info on custom mount options is available at man page for mount.fuse.
Note
allow_root
and allow_other
cannot be used as custom mount flags without enabling (uncommenting) user_allow_other
option in /etc/fuse.conf configuration file.
WebDAV (gio)
Requirements: Linux, gio
installed
Due to the wide variety of Linux distributions, Cryptomator only supports system integrated WebDAV volume type if gio is installed.
You can unlock your vault without gio
using WebDAV (HTTP Address), but support across distributions is not guaranteed.
Also, it’s up to yourself to figure out how to integrate WebDAV share with your distro.
OS Independent
WebDAV (HTTP Address)
Requirements: None - Works on all OS.
This volume type is always present and comes in handy when all other volume types fail to mount. It starts a local-only WebDAV server, which can be manually integrated into the system or accessed using a third-party application, like Cyberduck. Check out the regarding manuals for your OS on how to connect to a WebDAV server. The address of Cryptomators local-only WebDAV server can be copied from the vault detail screen by clicking the green “Copy” button.