Installing macFUSE
Installation
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
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.
Apple Silicon and Reduced Security
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 selectStartup 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.
Install macFUSE
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-clickInstall 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.

Approving macFUSE 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
orSystem Extension Updated
dialog, clickOpen System Settings
.If you clicked
OK
instead, clickOpen 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, clickAllow
.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 clickModify Settings
.In the second
Privacy & Security
dialog (Privacy & Security needs to authenticate to continue.
), enter your macOS account’s password, then clickOK
.
Restart
your Mac. It may restart multiple times.
Once macFUSE is installed, you're ready to add your first Workspace. ✅
Still no success?
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.
Last updated