New Proxmox Storage Plugin: TrueNAS ZFS over iSCSI via WebSocket API (TrueNAS 24.10 and 25.05 Compatible)

Reference 1: ZFS over iSCSI Storage Type Device in Proxmox is not Compatible with TrueNAS's iSCSI Target Protocols … But That Might Change Soon: A Summary of Events

Reference 2: Truenas Scale 2025.04 api error · Issue #205 · TheGrandWazoo/freenas-proxmox · GitHub

Reference 3: New TrueNAS WebSocket API-based Proxmox VE ZFS over iSCSI Plugin (alpha): GitHub - boomshankerx/proxmox-truenas: TrueNAS Websocket API Extension for Proxmox VE ZFS over iSCSI Storage

I posted previously about the then-current state of the ZFS-over-iSCSI storage mode in Proxmox’s ability to talk to TrueNAS SCALE 24.10 and 25.04 servers (see Reference 1). tl;dr, for various reasons, the ZFS Over iSCSI storage plugin in Proxmox VE cannot talk to TrueNAS SCALE 24.10.x or 25.04. To address this, the original plugin by TheGrandWazoo needed to either be updated to use the TrueNAS SCALE websocket API, or a replacement plugin was needed.

GitHub user boomshankerx reported the issue on TheGrandWazoo’s plugin repo at Reference 2. A lot of debugging and troubleshooting went on in that issue; it was a really impressive effort and worth a read.

Eventually, boomshankerx decided to fork and update TheGrandWazoo’s project, which amounted to a substantial re-write using TrueNAS’s new websocket API. It’s targeted at 24.10.2.x and 25.04.x.

An alpha version of the new Proxmox plugin for ZFS over iSCSI with has been released here, with a deb package: GitHub - boomshankerx/proxmox-truenas: TrueNAS Websocket API Extension for Proxmox VE ZFS over iSCSI Storage

The author has asked for people to test it; I decided to post it here because I figured some people here would be interested in trying it. I’m building a PVE test node now that I’m going to put it on, but I don’t have a ton of experience with TrueNAS and none with iSCSI, so I’m not sure I’ll be the most useful tester ever.

I asked the author what he needed for issue reports. Here’s what he said:

My debugging output will show both in syslog and in the UI. Just let me know something doesn’t work.