User Manual Tuxera
User Manual Tuxera
User Manual Tuxera
Tuxera Inc.
Westendintie 1, FI-02160 Espoo, Finland
TABLE OF CONTENTS
1. Introduction to Microsoft NTFS for Mac by Tuxera ........................................................... 3
1.1. What is a file system driver?................................................................................................. 3
1.2. How does Microsoft NTFS for Mac by Tuxera work? .......................................................... 4
5. Troubleshooting ................................................................................................................... 18
5.1. Common installation issues ................................................................................................ 18
6. Support.................................................................................................................................. 22
7. Acknowledgements ............................................................................................................. 23
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Thank you for purchasing Microsoft NTFS for Mac by Tuxera 2023! This manual will explain what
NTFS for Mac is, how to install it, and how to use it.
Microsoft NTFS for Mac is a file system driver, developed to enable full read/write support for NTFS-
formatted storage media on macOS. It is based on the open-source NTFS-3G project, which
supports other operating systems (Linux, FreeBSD, Solaris, etc.) as well.
The current version of Microsoft NTFS for Mac can be used with both Intel- and Apple silicon-based
Macs. It can be used with the following operating systems:
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
File system drivers usually live in the kernel, the core of the operating system, which makes writing
them a risky business. If mistakes are made designing or implementing a kernel driver, it could easily
crash the whole system. This is not the case with Microsoft NTFS for Mac. Our driver lives in “user
space”—where all other applications are run—and is linked to the kernel through a file system bridge
known as macFUSE (a Mac port of FUSE or “Filesystem in USErspace”, originally created for the
Linux kernel).
This approach makes Microsoft NTFS for Mac safer and more portable, since system stability is not
affected in the event something goes awry with the file system driver. A theoretical downside with a
user space driver is that CPU usage will be higher due to increased kernel/user space communica-
tion, which may result in slower read/write speeds. In practice, however, the performance of Mi-
crosoft NTFS for Mac is comparable to that of kernel-based drivers.
The performance of Microsoft NTFS for Mac is often more than double that of its open-source coun-
terpart, NTFS-3G. The following graphs represent a performance comparison between NTFS-3G
and Microsoft NTFS for Mac on three different types of storage media:
Figure 1. Microsoft NTFS for Mac by Tuxera speed comparison (shorter time implies better performance)
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Like with most software on the Mac platform, the installer is delivered within a disk image (.dmg-file).
After the download is complete, double-click on the .dmg-file to mount the disk image and to display
its contents in Finder.
You will see two items inside the disk image: ‘Install Tuxera NTFS’ and ‘User Manual’. Double-
clicking on ‘Install Tuxera NTFS’ launches the package installer, which will guide you through the
setup process for Microsoft NTFS for Mac. You will need an administrator password for your Mac
during the installation, since some files need to be placed in protected system folders.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
As of macOS 10.13 “High Sierra”, third party kernel extensions are not permitted to load without
express permission from the user, to enhance system security. During setup, after copying the files
has been completed, you are now generally prompted to approve loading our system extension from
within System Settings:
The location of the notice about the blocked extension will be slightly different between different
versions of macOS. On older versions of macOS or Mac OS X, System Settings was known as
System Preferences. This is what System Settings looks like as of macOS 13 “Ventura”:
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
In order to remove the need for each user individually to approve the extension on their workstations,
you need to use your management tool to specify that extensions signed with our Developer- or
Team ID (PPNVCC9Z68) are allowed without intervention. Please consult the documentation for the
tool you are using for specific instructions.
2.2.2. Activation
Normally activating NTFS for Mac requires entering a product key during installation, or into the
designated field on the Activation-tab in System Settings after installation has been completed. This
activation method can become tedious in an organization with a volume license and a large number
of Macs. To activate a series of workstations without this manual step, a settings file endowed with
a valid volume license needs to be obtained from the Tuxera Support Team.
The settings file contains activation data specific to each volume license and cannot be generated
by the client. The client will generate conflicting data if activated manually. If you’ve previously had
NTFS for Mac installed and activated, the conflicting data can be found in:
You can use your preferred method of distribution to copy the included com.tuxera.NTFS.plist-file
to /Library/Preferences/ on the systems you wish to activate.
kextutil -v 6 /Library/Filesystems/tuxera_ntfs.fs/Contents/Resources/Support/10.9/tuxera_ntfs.kext
To make sure the extension is loaded, you can use the command
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Figure 3. Update
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
When exchanging data between computers running Windows and your Mac, always be sure to use
the feature known as ‘Safely remove hardware’ before detaching your storage device. If this feature
is not used, problems can result mounting the volume on your Mac due to errors or inconsistencies
in the state of the file system. Should you get an error message when attempting to mount an NTFS
volume on your Mac, please use 'chkdsk' in Windows to correct problems with the volume in
question.
Microsoft NTFS for Mac by Tuxera will also warn before mounting “hibernated” partitions, or
partitions that contain a hibernated state of a Windows system, since this can also lead to data loss.
On your Mac, safely detaching an NTFS volume works just as with any other file system; simply click
on ‘Eject’-button adjacent to the volume name in Finder or Disk Utility, or drag and drop the volume
icon into the Trash in Dock.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
For removable storage devices that you will also use in Windows, it is preferred to select the legacy
Master Boot Record (MBR) partitioning scheme, when possible. This gives the widest compatibility
with different versions of the Windows operating-system.
When a larger storage device is used, selecting GUID Partition Map will be necessary due to the
limitations of MBR regarding individual volume sizes.
Disk Utility can also be used in Terminal with the command diskutil. Type the diskutil command in a
Terminal-window without any parameters for a brief set of instructions on its use. When using the
command, the file system parameter “Tuxera NTFS” can be specified where applicable.
Note that NTFS file systems should not be used in conjunction with the Apple Partition Map
partitioning scheme. Apple Partition Map was used by default on the now vintage-classified
PowerPC Macs and cannot be read by any Windows system.
In addition, you can always check and repair NTFS volumes in Windows. Please see the following
link for more details: https://support.microsoft.com/en-us/kb/2641432
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
• General – Settings that apply to all NTFS volumes, or overall driver function
• Volumes – Settings that can be set to apply to an individual file system or disk
You are required to authenticate as an administrator by clicking on the padlock-icon at the bottom
left corner of the window and entering your password in order to make changes to the driver settings
on the General-tab, since they apply system-wide.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
4.1.1. Globally
You can disable Microsoft NTFS for Mac without uninstalling it by clicking the ‘Disable’- toggle-button
on the General-tab in settings. When disabled, NTFS for Mac will ignore all NTFS volumes that are
attached to the system and pass on the mount request to the built-in NTFS driver (or any other
installed NTFS driver with a higher priority).
Once disabled, all driver options are grayed out, and the toggle label is changed to ‘Enable’.
This setting is governed by the control file: .Tuxera-NTFS/disable-driver at the root of the volume.
To re-enable the volume this file will have to be removed. Removing the file can be tricky since the
volume will now only be mounted in read-only mode. To get around this, connect the storage device
to a computer running Windows and remove the file that way, or force your volume to mount with
the write-option via Terminal on your Mac.
4.2.1. Globally
You can disable the internal caching layer by unchecking the ‘Enable file system caching’-option in
the preference pane. Disabling the caching layer is usually preferable when there are concerns about
data consistency in the event of a system crash. For instance, if you're running a database on the
NTFS volume, it is ideal to have as few layers of caching as possible to guarantee the integrity of
the data.
Turning off the caching layer reduces performance considerably and is not recommended for general
use. Caching is enabled by default.
This setting is governed by the control file: .Tuxera-NTFS/disable-caching at the root of the volume.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
If you regularly attach volumes that have not been cleanly unmounted—for instance if your
colleagues regularly forget to use the “Safely remove hardware” feature before detaching NTFS
drives from a Windows computer—then you may suppress the dialog from Microsoft NTFS for Mac
and automatically recover any attached NTFS volume by enabling the ‘Always mount unclean
volumes’-option.
If something doesn't seem to work properly, or you want to find out what happens when you attach
an NTFS volume for troubleshooting purposes, you can enable debug log to get more information.
When debug log is enabled, the utility that helps mount, format, and probe volumes (among other
important things) writes more detailed information in designated log files.
The log file is saved to /Library/Logs/tuxera_ntfs_util.log, but if access to this location is prohibited,
it will be placed in the user's local library instead (~/Library/Logs/tuxera_ntfs_util.log).
Note: NTFS for Mac will always log errors regardless of this setting. Debug log provides extremely
verbose and detailed log entries more suitable for bug reports.
This option disables the dialog that Microsoft NTFS for Mac displays when encountering a volume
containing a hibernated Windows session. The dialog asks the user for permission to purge that
session in order mount the volume. If this option is toggled, mounting a volume will silently fail when
a hibernated Windows session is encountered, and the risk of data loss due to carelessly choosing
the wrong option in the dialog is eliminated.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
5. Troubleshooting
5.1. Common installation issues
5.1.1. Your current security settings prevent the installation of system extensions
On newer Macs, especially with Apple M1 or M2-processors, the default macOS security policy no
longer allows third party extensions by default. During the installation, when prompted to allow the
blocked extension, you may encounter the following notice:
When this occurs, the security policy must be changed to accommodate Microsoft NTFS for Mac:
• Turn your Mac back on, but keep holding the power button past the startup chime and Apple
logo until you see a boot option selection screen. [Figure 9a]
• Choose Options, click on 'Continue', and enter your password if prompted to do so.
• From the menu at the top of the screen, choose Utilities > Startup Security Utility [Figure 9b]
• After selecting your primary hard disk, click on the button labeled 'Security Policy...' [Fig. 9c]
• Toggle the Reduced Security-mode and check the option to Allow user management of ker-
nel extensions from identified developers, then click 'OK'. [Figure 9d]
Please see the next page for a visual walk-through of these steps!
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Figure 9c. Select system for which the security policy will be changed
Figure 9d. Set to ‘Reduced Security’ and allow managing kernel extensions
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
The easiest way to confirm this issue is to load our extension manually via Terminal, and observe
the output.
To do this, open Terminal (Applications → Utilities → Terminal) and enter the following command
(with sudo):
kextutil -v 6 /Library/Filesystems/tuxera_ntfs.fs/Contents/Resources/Support/10.9/tuxera_ntfs.kext
If the permissions are incorrect, you will see the following in the output after entering the command:
Fixing the issue requires starting macOS Recovery. To do so, power down and restart your Mac
while holding the buttons ⌘+R on your keyboard. Hold the buttons before you hear the startup chime
and until you see a progress bar. If you succeed, you will enter the macOS Utilities-menu:
• Click on the Utilities-menu at the top of the screen and choose Terminal.
• If you've entered the command correctly and there are no error messages, you can restart
your Mac through the Apple-menu and resume installing NTFS for Mac.
Please see the next page for a visual walk-through of these steps!
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
The presence of another driver can interfere with the functioning of NTFS for Mac and as such it is
strongly recommended that the other driver be removed.
Due to the nature of third party file system drivers on macOS, methods such as dragging and drop-
ping the application to the Trash are likely not sufficient to completely remove the software, as not
all of the software resides in the app-bundle. You will need to consult the instructions supplied with
the other driver to determine how to remove the components that are not in the Applications-folder.
6. Support
As a licensee of Microsoft NTFS for Mac by Tuxera, you are entitled to our priority customer support
for this product. If you experience any problems, we encourage you to browse our Help Center at
https://macsupport.tuxera.com/
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.
User Manual TUXERA
Microsoft NTFS for Mac by Tuxera
7. Acknowledgements
This package would not exist if it were not for the following projects/individuals:
• Csaba Henk and Alejandro Pulver, who integrated FUSE and NTFS-3G into FreeBSD, thus
also providing the foundation for NTFS-3G running on Mac OS X
• The FUSE: Filesystem in USErspace project, led by Miklos Szeredi, which provides the
foundation for user space file system development
• The Linux-NTFS project, led by Anton Altaparmakov, which provides many important tools
used in this package
• Paul Marks, who created the first NTFS-3G file system bundle for Mac OS X and documented
many of the aspects on how the DiskArbitration framework handles volumes
A shout out to Jason Dee and Boxiong Li for helping improve the Chinese translation!
We also want to thank many other contributors and testers within the community.
Copyright © 2008–2023 Tuxera Inc., all rights reserved. Tuxera is a trademark of Tuxera Inc. in the United States, Europe, Japan, and other countries.