Skip to content
gitsync edited this page Jul 14, 2026 · 1 revision

iSCSI provides block-level access to ZVols over the network — for hypervisors (VMware, Proxmox, Hyper-V), databases, and any workload that needs raw block storage.

Enabling the feature

iSCSI is an optional feature. Install it from Requisites → Optional Features → Enable iSCSI Feature (targetcli-fb):

Requisites — Optional Features

The iSCSI Shares sidebar item appears once installed.

Setting up a target

  1. Create a ZVol first — iSCSI targets are backed by ZVols (see Datasets & ZVols)
  2. Go to iSCSI Shares → Configure and set:
    • Base name — IQN prefix (e.g. iqn.2026-01.com.example)
    • Port — TCP port (default 3260)
  3. Click + New iSCSI Share:
    • ZVol — select the backing ZVol
    • Hosts — allowed initiator IQNs, or ALL
    • Comment — optional

Host registry

Initiator IQNs are stored once and reused across share definitions — add, edit, and remove them inline in the share modal.

Service control

Start / Stop / Restart buttons control the target service; the portal auto-detects the installed service name.

Connecting from a client

Linux (open-iscsi):

iscsiadm -m discovery -t sendtargets -p <server-ip>:3260
iscsiadm -m node --login
iscsiadm -m session

Windows: iSCSI Initiator → Discovery → enter server IP and port 3260.

Proxmox: Datacenter → Storage → Add → iSCSI.

Related pages

Clone this wiki locally