DOCS InstallGet StartedUser GuideRelease Notes

macFUSE Installation

macFUSE is required to mount your ObjectiveFS filesystem on macOS. This document covers the steps to install it: the download, enabling kernel extensions on Apple silicon and allowing the macFUSE system extension. Install ObjectiveFS first, see the Get Started guide.

Download and install macFUSE

macFUSE dmg
For macOS 12 and newer (reference: macFUSE). ObjectiveFS uses the macFUSE kernel extension. The FSKit backend is not supported yet.

ObjectiveFS itself supports macOS 10.13 and newer, a lower floor than the current macFUSE. On macOS 11 and older, install an earlier macFUSE or osxfuse release that supports your version; the steps below are written for the current one.

Enable kernel extensions (Apple silicon only)

When the macFUSE installer asks, click "Open System Settings". In Privacy & Security, click "Enable System Extensions…", enter your password and choose "Shut Down".

SYSTEM SETTINGS // PRIVACY & SECURITYGENERALAPPEARANCEPRIVACY & SECURITYDESKTOP & DOCKSECURITYSOME SYSTEM SOFTWARE REQUIRES YOURATTENTION BEFORE IT CAN BE USED.ENABLE SYSTEM EXTENSIONS…PASSWORDTHEN: SHUT DOWN

Press and hold the power button until "Loading startup options" appears. Choose Options, then Utilities → Startup Security Utility. Select your startup disk, click "Security Policy…", choose "Reduced Security" and tick "Allow user management of kernel extensions from identified developers". Click OK and restart. Intel Macs skip this step.

RECOVERY // STARTUP SECURITY UTILITY // SECURITY POLICYFULL SECURITYREDUCED SECURITYALLOW USER MANAGEMENT OF KERNEL EXTENSIONSFROM IDENTIFIED DEVELOPERSALLOW REMOTE MANAGEMENT OF KERNEL EXTENSIONSTHEN: RESTARTOK
Allow the macFUSE system extension

Open System Settings → Privacy & Security. Next to "System software from developer Benjamin Fleischer was blocked from loading", click "Allow", enter your password and restart when asked.

SYSTEM SETTINGS // PRIVACY & SECURITYGENERALAPPEARANCEPRIVACY & SECURITYDESKTOP & DOCKSECURITYSYSTEM SOFTWARE FROM DEVELOPER"BENJAMIN FLEISCHER"WAS BLOCKED FROM LOADING.ALLOWTHEN: RESTARTMACFUSE READY

Reference: macFUSE Getting Started

Tips

  1. To upgrade macFUSE later, see upgrading to a new macFUSE version.

If you have questions, please email us at support@objectivefs.com.


Last updated ObjectiveFS staff

ObjectiveFS is a shared filesystem for Linux and macOS that automatically scales up and out with high performance. In production use by Fortune 500 companies since 2013.