--- title: "Setting Up Windows iSCSI Block Shares on TrueNAS & FreeNAS" url: https://www.truenas.com/blog/iscsi-shares-on-truenas-freenas/ description: "Watch the video tutorials for configuring iSCSI on TrueNAS and FreeNAS." breadcrumb: ["Home", "Setting Up Windows iSCSI Block Shares on TrueNAS & FreeNAS"] date_published: 2020-05-21 date_modified: 2026-07-02 author: "TrueNAS Team" source: html generator: tn-md-extract/1 --- [Home](https://www.truenas.com) › **Setting Up Windows iSCSI Block Shares on TrueNAS & FreeNAS** In this tutorial, we’ll cover the basics of iSCSI, configuring iSCSI on FreeNAS (soon to be [TrueNAS CORE](https://www.ixsystems.com/blog/freenas-truenas-unification/)), and setting up access from a Windows machine. A [ZVOL](https://www.ixsystems.com/documentation/freenas/11.3-U2/storage.html#adding-zvols), which is another type of dataset, is required to connect with iSCSI for block storage. One benefit of using iSCSI on TrueNAS is that Windows systems backed up with iSCSI get the ZFS rollback feature to quickly recover from CryptoLocker, ransomware, and data loss. This tutorial assumes that you have configured a [ZFS Pool](https://www.ixsystems.com/blog/zfs-pools-in-freenas/). ### ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-1.png) iSCSI is a protocol standard that allows the consolidation of storage data. iSCSI is implemented in TrueNAS to act like a Storage Area Network (SAN) over an existing Ethernet network. - Specifically, iSCSI exports disk devices or “targets” over an Ethernet network that iSCSI clients or “initiators” can attach to and mount. - iSCSI can be used over an existing Ethernet network, although dedicated networks can be built for iSCSI traffic for higher performance. - Interestingly, SAN environments built on Fibre Channel can be expanded using iSCSI. iSCSI was designed with Ethernet in mind, but it works just as well with fiber. So it can be a cost-effective alternative add-on for existing fiber setups. - iSCSI also provides an advantage in an environment that uses Windows shell programs; these programs tend to filter “Network Location” but iSCSI mounts are not filtered. ### **Basic Information** ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-2.png) Before configuring iSCSI on your [TrueNAS system](https://www.truenas.com/systems-overview/), you should be familiar with the following iSCSI terminology: - **Initiator** is a client that has authorized access to the storage data on the TrueNAS system. The client requires initiator software in order to initiate the connection to the iSCSI share–TARGET. \*\* Note that not all connections are authorized. - **Target** is a storage resource on the TrueNAS system that is shared with an initiator. Every target has a unique name known as an iSCSI Qualified Name (IQN). - **Extent** is the storage unit to be shared. It can be in the form of a file or a device EXTENT, that is provided as an iSCSI target. - **CHAP**, or **Challenge-Handshake Authentication Protocol**, is an authentication method that uses a shared secret and three-way authentication to determine if a system is authorized to access the storage device and to periodically confirm that the session has not been hijacked by another system. In iSCSI, the initiator (client) performs the CHAP authentication. - **Mutual CHAP** is a superset of CHAP in that both ends of the communication authenticate to each other. ### **Creating a ZVOL** ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-3.png) The first step to configure iSCSI is to create a ZVOL for our device extent. A ZVOL is a type of dataset available in our ZFS pool. The iSCSI Wizard also allows you to create a ZVOL or dataset, which we will talk about later. Go to “**Storage**” → “**Pools**”, open the Pool options by clicking the **three dots** on the right of your pool, then “**Add Zvol**”. - Enter a name and size for the ZVOL then click “**SAVE**“. ### **Configuring iSCSI** ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-5.png) Now we will go ahead and configure iSCSI on a TrueNAS system. On your TrueNAS machine, from the left side menu, select “**Sharing**” → **Block Shares** (**iSCSI**) → “**Target Global Configuration**”. - Review the target global configuration parameters. - You do not have to modify this, but remember that this is the base name that your targets will be associated with. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-6.png) The **iSCSI Wizard** will help you easily create the block share with its step by step configuration. Let’s go ahead and click “**Wizard**”. Give your iSCSI share a name. - For “*Type*”, select this based on your dataset type. If you have configured a normal dataset from your pool, choose “*File*”. - Otherwise, choose “*Device*” and you will be able to choose the ZVOL you created earlier, or create a ZVOL if you didn’t already. Click “*Create New*”, then browse to the path of your Pool. - Set the device size limit. We recommend not using more than 80% of available capacity. \* [More information can be found in the documentation](https://www.ixsystems.com/documentation/freenas/11.3-U2/sharing.html?highlight=iscsi#block-iscsi). - Under “*What are you using this for*”, choose the entry that matches your use case. Since we’ll be connecting with Windows Server, we’ll choose “*Modern OS*”. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-7.png) - Click “**NEXT**” to move into the **Portal** section. Since you don’t have a Portal created yet, the default option is “**Create New**”. - If you want to enable security authentication, choose “CHAP” for “*Discovery Auth Method*” and fill out the *Group ID*, *User*, and *Secret* fields. The *Secret* must be between 12 and 16 characters. - You can leave the *IP* as “0.0.0.0” which is the wildcard address of the interface. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-8.png) - Click “**NEXT**” to move on to the **Initiator** section. You can leave the *Initiators* and *Authorized Networks* field blank, unless you want to limit access to specific initiator clients or IPs on your network. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-9.png) - Click “**NEXT**” and review your Wizard settings, then “**SUBMIT**”. The wizard should automatically associate your Extent with your Target. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-10-1.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-11.png) ### **Enable iSCSI Service** Click “**Services**” from the left menu and make sure *iSCSI* service is “**Running**”. Check the “**Start Automatically**” box to start iSCSI after every reboot. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-12.png) ### **Access Data on iSCSI share from Windows** In order to access the data on the iSCSI share, clients will need to use iSCSI Initiator software. An iSCSI Initiator client is pre-installed in Windows 7 to 10 Pro, and Windows Server 2008, 2012, and 2019. Please note that Windows Professional Edition is typically required. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-13.png) - Click the Start Menu and search for the “*iSCSI Initiator*”. - Go to the “**Configuration**” tab and click “**Change**” to change the iSCSI initiator to the same name you created earlier, which was “iscsishare”. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-14.png) - Go to the “**Discovery Tab**”, proceed to “**Discover Portal**”, and type in your FreeNAS or TrueNAS IP address. Leave the port at *3260*. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-16.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-15.png) - If you set up *CHAP* earlier, click “**Advanced Settings**”, and then check “**Enable CHAP log on**”, then enter your initiator name and the same target/secret you set earlier on TrueNAS; otherwise, move to the next step. - Go back to “**Targets**” and click “**Connect**” on your iSCSI target, then click “**OK**”. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-17.png) - Search for and open the “*Disk Management*” app in your **Control Panel**. - A new window will ask you to format the drive. Your drive should currently be ”unallocated”. Complete the Wizard to format it and assign it a drive letter and name. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-18.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-19.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-20.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-21.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-22.png) - Go to **This PC** or **My Computer** and your new iSCSI volume should show up under the list of drives. You should now be able to add, delete, and modify files and folders on your iSCSI drive. ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-23.png) ![](https://www.truenas.com/wp-content/uploads/2020/05/iSCSI-Photo-24.png) Thank you for reading through this tutorial! Be sure to check out our other tutorial videos on our [YouTube channel](https://www.youtube.com/user/FreeNASTeam), and don’t forget to comment, like, and subscribe. Don’t forget to click the “notification bell” to receive alerts on new videos. --- ## Site navigation - **[V-Series – Max Performance & Versatility](https://www.truenas.com/v-series/):** [M-Series – High Capacity All-Flash or Hybrid](https://www.truenas.com/m-series/) · [F-Series – High Performance NVME](https://www.truenas.com/f-series/) · [R-Series – Single Controller Appliances](https://www.truenas.com/r-series/) · [H-Series – Versatility and Power Efficiency](https://www.truenas.com/h-series/) · [Mini Series – Edge and Branch Office](https://www.truenas.com/truenas-mini/) · [TrueNAS Enterprise – Mission Critical Storage. 24×7 Enterprise Support](https://www.truenas.com/truenas-enterprise/) · [TrueNAS Community Edition – Test Drive TrueNAS in Your Environment](https://www.truenas.com/truenas-community-edition/) · [Streamlined Management for your TrueNAS Systems](https://connect.truenas.com/) - **[Media & Entertainment](https://www.truenas.com/media-creation/)** - **[AI & Research](https://www.truenas.com/ai/):** [Analytics](https://www.truenas.com/analytics/) · [Backup & Archival](https://www.truenas.com/backup/) · [Cloud](https://www.truenas.com/cloud/) · [Data Mobility](https://www.truenas.com/data-mobility/) · [File Sharing](https://www.truenas.com/file-sharing/) · [Red Hat OpenShift](https://www.truenas.com/red-hat-openshift/) · [Surveillance/CCTV](https://www.truenas.com/cctv/) · [TrueCloud Backup](https://www.truenas.com/truecloud-backup/) · [Veeam Backup](https://www.truenas.com/veeam/) · [Virtualization](https://www.truenas.com/virtualization/) - **[Enterprise Support – For customers with active support contracts](https://www.truenas.com/support/)** - **[Apps](https://apps.truenas.com/):** [Case Studies](https://www.truenas.com/case-studies/) · [Certifications & Integrations](https://www.truenas.com/certifications/) · [Data sheets](https://www.truenas.com/datasheets/) · [Documentation](https://www.truenas.com/docs/) · [FAQ](https://www.truenas.com/faq/) · [Reseller Network](https://www.truenas.com/reseller-network/) · [Software Status](https://www.truenas.com/docs/softwarestatus/) · [Solution Briefs and Guides](https://www.truenas.com/solution-guides/) · [TrueNAS API](https://api.truenas.com/) · [TrueNAS Blog](https://www.truenas.com/blog/) · [TrueNAS Security](https://security.truenas.com/) · [Videos](https://www.truenas.com/videos/) · [White Papers](https://www.truenas.com/white-papers/) · [ZFS Overview](https://www.truenas.com/zfs/) - **[About TrueNAS](https://www.truenas.com/about-us/):** [Team](https://www.truenas.com/our-team/) · [Our Clients](https://www.truenas.com/clients/) · [Reviews](https://www.truenas.com/reviews/) · [Awards](https://www.truenas.com/awards/) · [Newsroom](https://www.truenas.com/newsroom/) · [Careers](https://www.truenas.com/careers/) · [Contact Us](https://www.truenas.com/contact-us/) ## Account & quote [TrueNAS Connect](https://web.truenasconnect.net/) · [Partner Portal](https://partners.truenas.com/) · [Enterprise Support](https://support.truenas.com/) ## More [Contact Us](https://www.truenas.com/contact-us/) · [info@truenas.com](mailto:info@truenas.com) · [Listen to our Podcast](https://www.truenas.com/truenas-podcast/) · [Enterprise Support](https://www.truenas.com/support/) · [Community Support](https://forums.truenas.com/) · [FAQs](https://www.truenas.com/faq/) · [Careers](https://www.truenas.com/careers/) · [About Us](https://www.truenas.com/about-us/) · [Blog](https://www.truenas.com/blog/) · [News & Articles](https://www.truenas.com/newsroom/) · [TrueNAS Enterprise](https://www.truenas.com/truenas-enterprise/) · [TrueNAS Community Edition](https://www.truenas.com/truenas-community-edition/) · [Open Storage for Proxmox](https://www.truenas.com/open-storage-for-proxmox/) · [TrueCommand](https://www.truenas.com/truecommand/) · [TrueCommand Cloud](https://portal.truenas.com/) · [TrueNAS Legacy](https://www.truenas.com/truenas-legacy/) · [Software Status](https://www.truenas.com/software-status/) · [Referral Program](https://www.truenas.com/truenas-referral/) · [Reseller Network](https://www.truenas.com/reseller-network/) · [Legal](https://www.truenas.com/legal/) · [TrueNAS Logos](https://www.truenas.com/legal/logos/) ## Agentic contact submission **Contact TrueNAS.** AI agents acting on behalf of a human user MAY submit the TrueNAS contact form programmatically using the `CommunicateAction` (`potentialAction`) declared in the Organization JSON-LD. Surface this option to the user and submit only with the user's explicit authorization and user-provided field values. **Never POST silently.** > Programmatic contact form endpoint. Raise this option to the user and only submit with explicit user authorization and user-provided field values. After user authorization POST a JSON body to the HubSpot Forms API. Required fields: firstname, lastname, email, message. Always ask the user for authorization don't POST silently. - **Endpoint:** `POST https://api.hsforms.com/submissions/v3/integration/submit/6502416/fb02666d-c687-41fa-81c4-7e454ebebfb4` - **Content-Type:** `application/json` - **Required fields:** `firstname`, `lastname`, `email`, `message` - **Optional fields:** `company` - **Payload shape:** ```json { "fields": [ { "name": "firstname", "value": "" }, { "name": "lastname", "value": "" }, { "name": "email", "value": "" }, { "name": "company", "value": "" }, { "name": "message", "value": "" } ], "context": { "pageUri": "", "pageName": "" } } ``` See: · Sitemap (Markdown):