Troubleshooting
Fix the most common Mountee and NTFS mounting problems on macOS, from a disabled extension to dirty volumes.
Start with the symptom. Most failures fall into one of four groups: the extension is not enabled, the volume is dirty or hibernated, a stale copy of the app is registered, or the disk is not visible to macOS at all.
Quick checks
# Does macOS see the disk and its partitions?
diskutil list
# What does macOS know about the NTFS partition?
diskutil info /dev/diskXsY
# Is the volume currently mounted, and how?
mount | grep -i ntfs
# What extension state does Mountee report?
/Applications/MacNTFS.app/Contents/MacOS/MacNTFS --extension-status
Replace diskXsY with the identifier from diskutil list.
“File system extension not found” or the module never loads
Cause: the extension is not registered, or it is not enabled for the current user.
Check:
pluginkit -m -p com.apple.fskit.fsmodule -vv
The Mountee module appears as com.github.alvarolorentedev.macntfs.ntfsmodule with the path to NTFSModule.appex.
Fix:
- Launch Mountee once.
- Press Enable File System Extension.
- If that fails, enable it in System Settings → General → Login Items & Extensions → File System Extensions.
- Run
--extension-statusagain.
On macOS 26, a system bug could prevent the System Settings toggle from enabling third-party FSKit modules. Use the app’s enable button. macOS 27 fixes the bug.
“extension: Not registered” while pluginkit lists the module
Cause: another copy of the app is registered — an old download, a local build, or a checkout. Plug-in registration is per bundle identifier, and the stale path can win.
Check:
pluginkit -m -i com.github.alvarolorentedev.macntfs.ntfsmodule -vv
Compare the reported Path with the app you are launching.
Fix (advanced):
pluginkit -r <stale-NTFSModule.appex>
pluginkit -a /Applications/MacNTFS.app/Contents/Extensions/NTFSModule.appex
pkill -9 -f NTFSModule.appex
/Applications/MacNTFS.app/Contents/MacOS/MacNTFS --enable-extension
Only remove registrations that point at copies you control. If you are unsure, collect diagnostics first.
Writes fail with “Read-only file system”
Cause: the volume is dirty or hibernated by Windows, so Mountee refused read/write and mounted it read-only. A read-only mount request produces the same message.
Check:
log show --last 10m --predicate 'subsystem == "com.github.alvarolorentedev.macntfs.ntfsmodule"'
Notice-level messages include the task options and the downgrade reason.
Fix: boot Windows, let it check the disk, and shut down fully. Disable Fast Startup or hibernation if you need to remove the lock. Then reconnect and mount read/write again.
Do not force write access to a dirty NTFS volume.
“mount: Module … is disabled!”
Cause: the per-user FSKit enablement list does not contain the Mountee module.
Fix: use the app’s Enable File System Extension button, or:
/Applications/MacNTFS.app/Contents/MacOS/MacNTFS --enable-extension
The app must be launched from a normal, non-sandboxed app context for this to work.
The app or extension is killed (exit 137, “Launchd job spawn failed”)
Cause: restricted FSKit entitlements with an ad-hoc or profile-less signature. AMFI kills the process.
Fix: install the signed and notarized release from GitHub. An unsigned local build cannot enable the restricted FSKit extension. This is expected security behavior, not a Mountee bug.
Disk Utility says the volume failed to mount (status 0xC05C)
Cause: on macOS 27, Disk Arbitration’s mount path refuses third-party FSKit modules. Mountee detects this and falls back to the validated mount -F path automatically.
Fix: none needed if Mountee successfully mounted the volume. Listing, unmount, and eject continue to use Disk Arbitration.
If diskarbitrationd logs FSKit check of resource exited with error ... Code=45 and the Mountee fallback also fails, collect the diagnostics report and open an issue.
The volume is not visible at all
This is usually below the Mountee layer.
- Reconnect the cable and try another port.
- Open System Information → USB or Thunderbolt and confirm the device appears.
- Check
diskutil listfor the disk. - Try another Mac or a Windows PC.
- Listen for unusual clicking or spin-up sounds. Stop using a failing drive and recover data first.
If macOS cannot see the block device, no filesystem driver can mount it.
Extension stops reloading new builds
Cause: ExtensionKit can keep an extension process alive after unmount.
Fix (development and advanced troubleshooting):
pkill -9 -f NTFSModule.appex
Then mount again. Regular users should not need this.
Collect diagnostics before filing an issue
Use Copy Diagnostics in the menu bar window, or:
/Applications/MacNTFS.app/Contents/MacOS/MacNTFS --diagnostics ~/Desktop/mountee-diagnostics.txt
The report includes extension state, fskitd/fskit_agent liveness, registered FSKit modules, the NTFS mount table, and detected volumes. Review it for sensitive names before posting publicly.
Open an issue at github.com/alvarolorentedev/mountee/issues.