TrueNAS storage for libvirt labs

Subvirt

Patched libvirt, virt-manager, and provider packages that let Ubuntu LTS and AlmaLinux 9/10 hosts create TrueNAS-backed VM disks through iSCSI or NVMe-oF.

Get started Browse packages View source

$ sudo virsh pool-define truenas-tank-iscsi.xml
$ sudo virsh pool-start truenas-tank-iscsi
$ sudo virsh vol-create-as truenas-tank-iscsi vm01-root 64G
# creates a TrueNAS zvol and resolves a stable /dev/disk/by-id path

TrueNAS-backed pools

Create and discover managed storage volumes through libvirt instead of jumping between a hypervisor and storage appliance.

iSCSI and NVMe-oF

Use the same libvirt workflow with traditional iSCSI targets or NVMe over Fabrics on faster storage networks.

Package-first testing

Install from apt and dnf repositories so test hosts exercise the same path users will use.

Package repositories

Ubuntu LTS

Stable apt repository endpoint for bionic, focal, jammy, noble, and resolute:

https://repo.subvirt.net/apt/ubuntu

AlmaLinux 9/10

Stable dnf repository endpoint:

https://repo.subvirt.net/yum/almalinux/$releasever/stable

These packages are experimental and intended for controlled lab environments while the integration is under active development. Archived release artifacts are available under https://repo.subvirt.net/archive/ for rollback and debugging.

Install flow

Add the repo

Import the Subvirt signing key and add the apt or dnf repository for your distro.

Install packages

Install the provider, patched libvirt storage driver, virt-manager support, and host transport tools.

Configure TrueNAS

Create a dedicated API user, store the API key locally, and set the management and storage addresses.

Create pools

Define a libvirt TrueNAS pool for iSCSI or NVMe-oF, then create VM volumes normally.

Read the full guide