TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

Adding an iSCSI Share

To get started, make sure you have created a zvol or a dataset with at least one file to share.

Go to Sharing > Block Shares (iSCSI). You can either set one up manually or use WIZARD to guide you through creation.

Wizard Setup Process


On Create or Choose Block Device:

  1. Enter a name for the iSCSI share. It can only contain lowercase alphanumeric characters plus a dot (.), dash (-), or colon (:). We recommend keeping the name short or at most 63 characters.

  2. Choose the Extent Type.

    • If the Extent Type is Device, select the Zvol to share from the Device menu.

    • If the Extent Type is File, select the path to the extent and indicate the file size.

  3. Select the type of platform to use for the share. For example, if using the share from an updated Linux OS, choose Modern OS.

  4. Click Next. The Portals screen displays.

  5. Select an existing portal or click Create New to add a portal.

    If you create a new portal, you must select a discovery authentication method.

    a. Select either CHAP or MUTUAL CHAP in the Discovery Authentication Method field.

    b. Select either None or Create New in the Discovery Authentication Group field. Create New displays additional configuration fields. If you select None you can leave Discovery Authentication Group empty.

    c. Enter a number in the Group ID field to identify the group.

    d. Enter the user name in the User field. This can be the same as the initiator.

    e. Enter a password of 12 to 16 characters in the Secret field and again in Secret (Confirm).

    f. Select the IP address(es) to use. If adding more than one IP address, click ADD and then select the IP address. Use to listen on all IPv4 or :: to listen on all IPv6 IP addresses.

    G. Select the TCP port number to use if different from the default.

    H. Click Next to display the Initiator screen.

  6. Enter the initiator information to use. Decide which initiators or networks can use the iSCSI share. Leave the list empty to allow all initiators or networks, or add entries to the list to limit access to those systems. Use the keyboard Enter between each entry. Click Next to display the Confirm Options screen.

  7. Confirm the settings you entered. To change any setting click BACK until you see the screen where you want to make changes.

  8. Click SUBMIT to save the iSCSI block share.

Manual Setup Process

To add or edit an existing iSCSI share, use the seven tab to access the various iSCSI configuration screens.

  1. Configure the share global configuration settings. Click the Target Global Configuration tab.


  2. Configure the portal settings. Click on the Portals tab.


    To add a new portal, click ADD and enter the basic and IP address information.

    To edit an existing portal, click next to the portal and select Edit.


  3. Configure the initiator settings (not required). Click on the Initiators Groups tab. Both the Add and Edit forms have the same settings fields.


    Use ADD to display the Initiators Add configuration screen. Either leave Allow All Initiators checked or configure your own allowed initiators and authorized networks.

    Click the icon for the initiator group and select Edit to display the Initiator Group Edit configuration screen.

  4. Configure authorized access networks. Click the Authorized Access tab.


    Click ADD to add a new authorized access network. Fill out the group, user and peer user information.

    Click next to the authorized access network and select Edit.

  5. Configure targets. Click the Targets tab.


    To add a new target, click ADD and enter the basic and iSCSI group information.

    To edit an existing target, click next to it and select Edit.

  6. Configure extents. Click the Extents tab.


    To add a new extent, click ADD and enter the basic, type, and compatibility information.

    To edit an existing extent, click next to it and select Edit.

  7. Configure any associated targets. Click on the Associated Targets tab.


    To add a new associated target, click ADD and fill out the information.

    To edit an existing associated target, click next to it and select Edit.

Starting the iSCSI Service

To turn on the iSCSI service, go to Services locate iSCSI and click on the toggle. It should display the status Running.

To set it to start automatically when TrueNAS boots up, select the Start Automatically checkbox.


Click on the returns to the options in Sharing > iSCSI.