Announcing macFUSE 5.2.0 Posted on 09 Apr 2026
Release Notes
General
-
Update build process to use Xcode 26.4 (macOS 26.4 SDK)
-
Introduce a new open source API for mounting volumes using the
FSKitbackend. The new API enables fully sandboxed file systems, which was not previously possible.- The actual mount operation is performed over XPC. This means the
FSKitbackend does no longer rely onfork()/exec()to mount volumes. - The new API is already used by
libfuseandlibfuse3 - When sandboxing your file system server, add a Mach lookup exception for the
io.macfuse.mountservice - The new
MFMount.frameworkis located in/Library/Filesystems/macfuse.fs/Contents/Frameworks - Please note that the new API may change in future releases
- The actual mount operation is performed over XPC. This means the
FSModule (FSKit Backend)
-
Add support for a file system item’s allocation size. Sparse files are not currently supported, so the value of this attribute is the item’s size.
-
Add a workaround for an
FSKit/PluginKitissue that could prevent macFUSE volumes from being mounted after re-registering an already registered file system extension, requiring a restart of theFSKitsubsystem. -
Remove the obsolete broker launch daemon
io.macfuse.app.launchservice.broker, which was previously used to establish a connection between the file system extension and the file system server. -
Improve the built-in
logcommand to detect whether the output destination supports colored output. This is useful when piping log output to a file.% /Library/Filesystems/macfuse.fs/Contents/Resources/macfuse.app/Contents/MacOS/macfuse log stream Executing /usr/bin/log stream --debug --info --predicate "subsystem in { 'com.apple.FSKit', 'com.apple.LiveFS', 'io.macfuse' }" --color always Filtering the log data using "subsystem IN {"com.apple.FSKit", "com.apple.LiveFS", "io.macfuse"}" ... -
Improve the built-in
installcommand to support selecting which components to install. Supported options areprivileged-helpers,file-system-extensions, andall. Omitting the component is equivalent to specifyingall.% /Library/Filesystems/macfuse.fs/Contents/Resources/macfuse.app/Contents/MacOS/macfuse install --help USAGE: macfuse install [--components <components> ...] [--force] OPTIONS: -c, --components <components> Components to install (default: all) -f, --force -h, --help Show help information. -
Introduce foundational changes in preparation for new features in macFUSE 5.3
libfuse2
- Use new mount API
MFMount.frameworkfor mounting volumes using theFSKitBackend backend
libfuse3
-
Update
libfuse3to version 3.18.2 -
Use new mount API
MFMount.frameworkfor mounting volumes using theFSKitBackend backend -
Fix a bug when handling
FUSE_RENAMEmessages withFUSE_DARWIN_CAP_RENAME_EXTenabled that could cause the source and destination file names to be parsed incorrectly.
Sponsors
-
Work on this release has been sponsored by uint24 and others
-
If you would like to help sustain future development, please consider sponsoring the project through GitHub Sponsors


