v3.1.0

truenas-proxmox v3.1.0

Compatibility

Proxmox VE	Status
PVE 9.x	✅ Supported
PVE 8.x	❌ Not supported — dropped in v3.1.0. Use v3.0.x or upgrade PVE.
PVE 7 or older	❌ Not supported — use v2.x

Tested Proxmox VE Versions

• Proxmox VE 9.2.3 (kernel 7.0.6-2-pve)

Tested TrueNAS Versions

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

What's new in v3.1.0

Snapshot interface — Native ZFS snapshots via TrueNAS REST API. Disk-only and RAM snapshots both supported.

• Take, list, delete, and rollback ZFS snapshots on VM disks directly from the Proxmox UI
• Guest filesystem is frozen before snapping (requires QEMU guest agent for consistency)
• RAM snapshots: VM memory state stored as a raw iSCSI zvol on TrueNAS
• Rollback enforces ZFS constraint: only the most recent snapshot can be rolled back without deleting newer ones

PVE 9 API compatibility — api() bumped to 14, silencing the "older storage API" warning on PVE 9.

GitHub Pages testing dist — Beta builds from release/3.x now publish to the testing dist track on GitHub Pages. Cloudsmith testing channel retired.

Package improvements — Debian changelog included; apt changelog truenas-proxmox now works.

Breaking change

PVE 8 support is dropped. v3.1.0 requires PVE 9.x. If you are on PVE 8, stay on v3.0.x until you upgrade.

Installation

# New install (v3 track):
curl -fsSL https://thegrandwazoo.github.io/freenas-proxmox/public.gpg.key \
  | gpg --dearmor \
  | sudo tee /etc/apt/keyrings/truenas-proxmox.gpg > /dev/null

echo "deb [signed-by=/etc/apt/keyrings/truenas-proxmox.gpg] \
https://thegrandwazoo.github.io/freenas-proxmox v3 main" \
  | sudo tee /etc/apt/sources.list.d/truenas-proxmox.list

sudo apt update && sudo apt install truenas-proxmox

Upgrading from v3.0.x: sudo apt update && sudo apt upgrade

See docs/upgrade-paths.md for all migration scenarios.