Releases: OSNEXUS/pve-quantastor-plugin
Release list
v1.0.0 — first general-availability release
Highlights
First general-availability release of the QuantaStor storage plugin for Proxmox VE.
- VM disks and LXC containers on QuantaStor iSCSI block volumes, from one storage entry.
- Registers a first-class PVE storage type (
quantastor) — no PVE core files are patched. - Supported on PVE 9.1.x and 9.2.x.
- Upgrading from 0.2.x is just
dpkg -i— no configuration changes required.
Added since 0.2.1
- LXC container support (
rootdircontent type) — block-based container root filesystems, the same model as RBD and LVM-thin. - Filesystem-consistent snapshots of running containers via
volume_snapshot_needs_fsfreeze. - Restart migration for containers between cluster nodes.
- Extra mount points on QuantaStor storage.
pct fstrimdiscard passthrough.- Unprivileged containers.
- Web UI: the Content selector is now a multi-select offering Disk image and Container, both preselected on the Add dialog.
Fixed since 0.2.1
- Thin provisioning is now the default.
volume_createsendsthinProvisionedexplicitly — an absent boolean meant thick, so every volume was previously 100% space-reserved. Thesparseoption instorage.cfgwas dead code and is now honored (default on). - No more uninstall warning on package upgrade.
prermwarns about leftoverstorage.cfgentries only on actual removal. - Snapshot rollback and template conversion no longer fail after a guest stop. Session waits now default to 200s so they outlast QuantaStor's session-manager refresh cycle, which has a hardcoded 180s floor. Shorter waits failed deterministically, and the failed task left a rollback lock that blocked every subsequent start.
- Clones no longer fail about half the time.
activate_volumeretries the ACL add through transient 5xx responses: QuantaStor serves a clone as an async ZFS "instant replica" and can return the volume before SCST has created its iSCSI target. - More robust volume deletion.
free_imagefalls back to per-snapshot deletion when a cascade delete fails or partially completes, and retries through brief post-teardown busy windows.
Compatibility
- Declares storage
api() = 13. Loads on PVE 9.1.x (exact match) and 9.2.x (with a cosmetic "older storage API" notice). PVE 8.4.0 is not supported (itsAPIVERis 11). - Container templates (
vztmpl) are not supported — a block LUN cannot hold template tarballs, the same limitation RBD has. Keep templates on file-based storage such aslocal. - Use a current QuantaStor 7 build. Older 7.0 builds wedge volumes on template conversion and can refuse deletion of a freshly created snapshot for several minutes — see the
err=493section of the README.
Install
dpkg -i pve-storage-quantastor_1.0.0-1_all.debPVE services are restarted automatically by postinst, and dpkg triggers re-inject the UI panel and pool-scan endpoint after future pve-manager / pve-storage upgrades. Run it on every node in the cluster.
SHA256 e55d130da63723b8fd7c4f9762ead3fab2b779ff72851c34d7f297516290e08a
v0.2.1 — err=26 auth fix
pve-storage-quantastor 0.2.1
Fixed
- Authentication failures —
[err=26] Authentication check failed— when adding or activating QuantaStor storage. The plugin authenticated using LWP challenge-response, which attaches theAuthorizationheader only after the appliance issues a401 WWW-Authenticate: Basicchallenge whose realm matches exactly. Many QuantaStor versions answer an unauthenticated API request with an err=26 body under HTTP 200 instead of a challenge (and the realm string varies across versions), so the client sent no credentials and the appliance rejected the request — indistinguishable from a wrong password even when the password was correct (curl -uagainst the same appliance worked). The client now sends HTTP Basic credentials preemptively on every request, matchingcurl. No configuration change is required — just upgrade the plugin.
Install
Download pve-storage-quantastor_0.2.1-1_all.deb and run on each PVE node:
dpkg -i pve-storage-quantastor_0.2.1-1_all.debSupported on Proxmox VE 9.1 and 9.2.
SHA256
90d9f5cfa5da8d3f7e7236b4e9580cc37f41dde6d94da2a830a4ad759b7c80bb pve-storage-quantastor_0.2.1-1_all.deb
v0.2.0 — first-class QuantaStor storage type
Install on every node; postinst restarts PVE services and registers triggers so the UI panel and pool-scan endpoint survive pve-manager/pve-storage upgrades.
Highlights
- Full VM disk lifecycle: create, snapshot, rollback, online resize, clone, template
- iSCSI initiator lifecycle managed automatically (login/logout/rescan)
- Web UI dialog: storage-ID auto-fill, pool scan dropdown, content type locked to Disk image
- Credentials stored in pmxcfs (
/etc/pve/priv/storage/<id>.pw), never instorage.cfg - Validated on PVE 9.1.x and 9.2.x, including two-node cluster live migration
Compatibility
Loads on PVE 9.1.x and 9.2.x (declares api=13). Not supported on 8.4.x.
Debian Checksum
SHA256: 11a4cd297c3e5a67ca5d53f94333ca09e2f26bc5b5c63a035c18fc66f1d18a38
v0.1.0-alpha
pre-release quantastor proxmox plugin
Key Features
• ZFS-over-iSCSI provisioning – Seamlessly create and manage QuantaStor-backed ZFS volumes for Proxmox VM disks directly from the Proxmox VE interface.
• ZFS snapshots and clones – Leverage QuantaStor’s ZFS snapshot and clone APIs to manage VM disk snapshots and clones natively through Proxmox workflows.
• Cluster-aware design – Designed for multi-node Proxmox VE clusters, ensuring consistent storage configuration and behavior across all nodes.
• VM migration support – Enables live migration of virtual machines between Proxmox nodes using shared QuantaStor-backed storage.
• Thin and thick provisioning – Choose between thin-provisioned volumes for efficient capacity utilization or fully reserved volumes for predictable performance.
• API-driven storage management – Deep integration with the QuantaStor API for automated provisioning, monitoring, and storage status reporting.
• Configuration validation – Built-in preflight checks help detect common misconfigurations early, reducing deployment errors and troubleshooting time.