Installing macFUSE
Last updated
Last updated
When you attempt to add your first Workspace on macOS, Mimiq performs a Preflight Check to confirm macFUSE is installed and loaded on your Mac. If not, Mimiq will prompt you to install macFUSE.
macFUSE is a macOS kernel extension used to create virtual filesystems. It's built and maintained by Benjamin Fleischer (https://osxfuse.github.io). Mimiq automatically downloads the installer for the latest macFUSE release that is confirmed to be compatible with Workspaces.
If you are on older machines, like Intel Macs, you might need to download an older version of macFUSE at https://github.com/osxfuse/osxfuse/releases.
If your Mac is managed through MDM, stop now and contact your System Administrator. The following steps below will not apply when using MDM.
On Apple silicon, you'll first need to set your Mac's security policy to "Reduced Security" to be able to load signed kernel extensions. If you're on Intel, you can skip to Install macFUSE.
Shut down your Apple silicon Mac.
Press and hold down the power button until your Mac boots. Your Mac will either send you directly into macOS' Recovery environment, or you'll see an Options button leading to that.
Log in with your user account and select the disk you want to use.
In the menu bar, go to Utilities, then select Startup Security Utility.
Click Security Policy...
Select Reduced Security, then enable:
Allow user management of kernel extensions from identified developers .
Click OK.
In the menu bar, select Shut Down.
Turn your Mac back on (press but don't hold the power button this time), then log in.
Click + Add Workspace. If Mimiq can't detect macFUSE on your Mac, Mimiq prompts you to install macFUSE first.
Click Install. Mimiq downloads a DMG with the macFUSE installer, then opens it for you.
In the mounted macFUSE DMG window, double-click Install macFUSE, then follow the prompts to complete installation.
Right before you complete macFUSE installation, a System Extension Blocked or System Extension Updated dialog will appear. Now you'll need to approve macFUSE to load in macOS.
Confirm which version of macOS you're using with Mimiq, then follow these steps to approve macFUSE to load in macOS:
In the System Extension Blocked or System Extension Updated dialog, click Open System Settings.
If you clicked OK instead, click Open Security & Privacy System Preferences in the installer.
System Settings will launch, taking you to Privacy & Security > Security.
Under the System software from developer "Benjamin Fleischer"… prompt, click Allow.
Two Privacy & Security dialogs will appear:
In the first Privacy & Security dialog (Privacy & Security is trying to modify your system settings.), enter the password from a local macOS Administrator account, then click Modify Settings.
In the second Privacy & Security dialog (Privacy & Security needs to authenticate to continue.), enter your macOS account’s password, then click OK.
Restart your Mac. It may restart multiple times.
Once macFUSE is installed, you're ready to add your first Workspace. ✅
Try loading the kernel extension manually in Terminal:
sudo /usr/bin/kmutil load -p /Library/Filesystems/macfuse.fs/Contents/Extensions/11/macfuse.kext
If that returns an error like system policy prevents loading and/or doesn't load macFUSE, your computer is very likely under IT management policies that prevent kernel extensions to load. Talk to your IT department first, they'll know what to do.