Skip to content

Commit 97d7a4c

Browse files
committed
Clarify macOS volume type trade-offs and recommendations
1 parent 1126cb5 commit 97d7a4c

File tree

1 file changed

+18
-11
lines changed

1 file changed

+18
-11
lines changed

docs/desktop/volume-type.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -81,22 +81,26 @@ Using WebDAV on Windows has the following drawbacks:
8181

8282
**Requirements:** macOS, macFUSE installed
8383

84-
:::warning
85-
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.
86-
:::
87-
88-
macFUSE volume type depends on a library provided by the [macFUSE project](https://osxfuse.github.io/).
84+
macFUSE is the most mature FUSE implementation for macOS.
85+
If you're comfortable with booting into recovery mode once to enable loading of kernel extensions, this is the recommended option for best compatibility and stability.
86+
macFUSE volume type depends on a library provided by the [macFUSE project](https://macfuse.github.io/).
8987
It is not included with Cryptomator due to license restrictions.
90-
However, you can install the latest version from [macFUSE's release page](https://github.com/osxfuse/osxfuse/releases).
88+
You can install the latest version from [macFUSE's release page](https://github.com/macfuse/macfuse/releases), following the [installation guide](https://github.com/macfuse/macfuse/wiki/Getting-Started).
9189

9290
By default, unlocked vaults are mounted to `/Volumes`.
93-
Info on custom mount options is available at [macFUSE wiki](https://github.com/osxfuse/osxfuse/wiki/Mount-options).
91+
Info on custom mount options is available at [macFUSE wiki](https://github.com/macfuse/macfuse/wiki/Mount-options).
92+
93+
:::note
94+
Apple has deprecated the OS APIs used by macFUSE since macOS 12.3, which requires additional steps during installation.
95+
Despite this, macFUSE remains the most stable option due to its maturity.
96+
:::
9497

9598
### FUSE-T (Experimental) {#fuse-t}
9699

97100
**Requirements:** macOS, FUSE-T installed
98101

99-
This volume type depends on a library provided by the new [FUSE-T project](https://www.fuse-t.org/).
102+
FUSE-T is a newer alternative that runs entirely in user space, avoiding the need for kernel extensions.
103+
This volume type depends on a library provided by the [FUSE-T project](https://www.fuse-t.org/).
100104
You can install it using brew:
101105

102106
```shell
@@ -107,16 +111,19 @@ brew install fuse-t
107111
By default, unlocked vaults are mounted to `~/Cryptomator/`.
108112
Info on custom mount options is available at [wiki of the FUSE-T project](https://github.com/macos-fuse-t/fuse-t/wiki#supported-mount-options).
109113

110-
:::note
111-
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.
114+
:::warning
115+
FUSE-T is less mature than macFUSE and some users have reported occasional malfunctions.
116+
Consider using macFUSE if you experience issues.
112117
:::
113118

114119
### WebDAV (AppleScript) {#webdav-applescript}
115120

116121
**Requirements:** macOS
117122

118-
WebDAV on macOS utilizes the scripting language [AppleScript](https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html) to mount/unmount the virtual drive.
123+
WebDAV requires no additional software installation and utilizes the scripting language [AppleScript](https://developer.apple.com/library/archive/documentation/AppleScript/Conceptual/AppleScriptLangGuide/introduction/ASLR_intro.html) to mount/unmount the virtual drive.
119124
By default, unlocked vaults are mounted to `/Volumes`.
125+
While sufficient for most file operations, the experience may feel less polished due to security warnings about the localhost connection not being secure.
126+
These warnings are expected since no certificate authority will issue TLS certificates for localhost.
120127

121128
## Linux-Based OS {#linux-based-os}
122129

0 commit comments

Comments
 (0)