Update 27 March 2021 : Further development is on hold until DriverKit 20.4 (Beta) is released, with support for IOUserSCSIParallelInterfaceController. This software will ultimately transition away from kernel extensions.

iSCSI initiator is a software initiator for macOS. It allows machines running macOS to connect to iSCSI targets. It automatically detects and mounts logical units on which users can then create and mount volumes. For more information about the iSCSI standard, see IETF RFC3720.

Builds of the kernel extension will not be signed and as a result macOS won't load them. Kext signing must therefore be disabled before attempting to install and load the kernel extension. Additionally, as of El Capitan, new security measures have been implemented that prevent the installation of files in certain protected system folders (unless the files are placed there by an appropriate installer). For this reason, it is important to follow the directions applicable to the relevant version of macOS prior to installation of the initiator.

Run the following command at a terminal prompt:

sudo nvram boot-args=kext-dev-mode=1

The kernel will load unsigned kernel extensions after a reboot.

Run the following command at the Recover OS terminal window:

csrutil disable

Follow the instructions in the System Integrity Protection Guide to access the Recover OS terminal window. Two reboots may be required during this process.

Download the desired release image file (.dmg), mount and run Installer.pkg to install the initiator. Similarly, run Uninstall.pkg to remove the initiator from your system. Ensure that no iSCSI targets are connected when updating or removing the initiator software, or you may experience an error during installation.

If you have an existing installation, logout of all targets before launching the installer. The installer will attempt to unload the iSCSI initiator kernel extension, if one exists and install new files. The iSCSI configuration will not be altered (existing settings are preserved).