v3.0.0-1

⚠️ Breaking Change — Upgrading from v2.x

v3.0 is not an in-place upgrade from v2.x. The plugin has been completely rewritten. Authentication, iSCSI connection model, and storage.cfg config keys all changed.

Before running apt upgrade, read the migration guide:

• Migrating from v2.x to v3.0 — step-by-step, VMs stay running
• Advanced migration scenarios
• Migration troubleshooting

Key changes at a glance:

• Auth: username/password removed — TrueNAS API key required (truenas_api_token)
• iSCSI: QEMU connects directly via iscsi:// — no iscsiadm, no kernel sessions, no /dev/disk/by-path/ entries on the host
• Package: freenas-proxmox is now a transitional stub that installs truenas-proxmox

---

Compatibility

Proxmox VE	Status
PVE 9+	✅ Supported
PVE 8.x	✅ Supported (EOL 2026-08-31 — plan upgrade to PVE 9)
PVE 7 or older	❌ Not supported — use v2.x

Tested Proxmox VE Versions

• Proxmox VE 9.2.3 (kernel 7.0.6-2-pve)
• Proxmox VE 8.4.19 (kernel 6.8.12-25-pve)

Tested TrueNAS Versions

• TrueNAS CORE 13.0-U6
• TrueNAS SCALE 24.10 Electric Eel
• TrueNAS SCALE 25.04
• TrueNAS SCALE 25.10

PVE 9 note: PVE 9 emits "Plugin is implementing an older storage API, an upgrade is recommended" — this is cosmetic and does not affect operation. It will be resolved in v3.1 when PVE 8 support is dropped.

---

Installation

See README → Installation.

Changes

See CHANGELOG.md.