TrueNAS iSCSI Setup for Linux Clients

🔧 TrueNAS Configuration

Navigate to Shares → Block (iSCSI)
Click Wizard
- Target: create new target
- Extent: Device type → select the Zvol you created
- Sharing Platform: Modern OS
- Portal: either “Create new” or default (you can use 0.0.0.0:3260)
- Initiator: leave blank (for any initiator) or specify your Linux host’s IQN
After wizard, edit the target if desired:
- Set Authorized Networks (e.g., 192.168.0.0/24) for access control
Save changes and verify that the target is listed

sudo apt install open-iscsi

sudo iscsiadm -m discovery -t sendtargets -p <truenas-ip>

sudo iscsiadm -m node -T <target-iqn> -p <truenas-ip> --login

✅ After login, a new device will show up, e.g., /dev/sdX

lsblk

Format the Disk Create an ext4 filesystem on the new disk:
```
sudo mkfs.ext4 /dev/sdX
```
Replace /dev/sdX with the actual device name from login step.
Create Mount Point
```
sudo mkdir -p /mnt/iscsi
```
Mount Manually (for testing)
```
sudo mount /dev/sdX /mnt/iscsi
```
Ensure the mount works before adding to persistent configuration.

Enable iSCSI Auto-login

sudo iscsiadm -m node -T <target-iqn> -p <truenas-ip> --op update -n node.startup -v automatic

Get the UUID of the Device
```
sudo blkid /dev/sdX
```
Copy the UUID="..." string from the output.
Update /etc/fstab Append bellow line:
```
UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/iscsi ext4 _netdev,noatime 0 2
```
- UUID=...: identifies the disk
- /mnt/iscsi: your mount point
- ext4: filesystem type
- _netdev: ensures mounting waits for network
- noatime: disable updating file's access time
- 0 2: backup and fsck order
Run a test:
```
sudo mount -a
```