[TUTORIAL] QuantaStor Proxmox Storage Plugin

cagamps

New Member
Dec 16, 2025
2
1
3
Hello all! I'm a developer with OSNEXUS.

We’re excited to announce the pre-release version of the QuantaStor Proxmox Storage Plugin, designed to simplify the management of QuantaStor storage within Proxmox VE clusters. This plugin enables seamless creation and management of ZFS-over-iSCSI storage directly from your Proxmox interface.



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.



Installation
The plugin currently supports Proxmox VE versions 8.4.x and 9.1.x.
There are two installation modes:
Patch mode – Adds QuantaStor plugin patches to existing Proxmox source files. Minimal disruption to the system. Requires the patch CLI utility.
Full copy mode – Replaces certain Proxmox source files with plugin-enabled versions. Intended for development or testing environments.
⚠️ Important: The plugin must be installed on all nodes in your cluster to avoid storage configuration inconsistencies.
Installation instructions are available on our GitHub repository. here



Pre-Release Notes
This is a pre-release version, and the following limitations currently apply:
• LXC container support has not been tested.
• Proxmox HA and replication functionality is not yet supported.
• API tokens and CHAP support are planned for future releases.
We welcome feedback from early adopters to help guide development of these features.




Getting Started
  1. Install the plugin on all nodes in your Proxmox cluster.
  2. Configure your QuantaStor storage server with a ZFS pool.
  3. Create a new storage configuration in Proxmox and select QuantaStor API as the iSCSI provider.
  4. Verify API connectivity and optionally enable SSL verification using your QuantaStor Root CA.



Feedback & Contribution
Your feedback is invaluable. Please submit issues, feature requests, or contributions through our GitHub repository.
Additional documentation can be found on the OSNEXUS wiki: Proxmox Storage Plugin. here
OSNEXUS Proxmox engineering email group : eng-proxmox@osnexus.com
 
Last edited:
  • Like
Reactions: gurubert
Hi,

Thanks for sharing your work. Upfront, are you aware of the native plugin mechanism that Proxmox VE offers, or are there reasons for developing this plugin as patch of the code over using the defined plugin interface?

See https://pve.proxmox.com/wiki/Storage_Plugin_Development
 
Hi,

Thanks for sharing your work. Upfront, are you aware of the native plugin mechanism that Proxmox VE offers, or are there reasons for developing this plugin as patch of the code over using the defined plugin interface?

See https://pve.proxmox.com/wiki/Storage_Plugin_Development
Yes we are working on a standalone plugin in the future. It was more a matter of inexperience than a design choice. When starting this project I was very unfamiliar with the plugin system and proxmox pve in general, we wanted something that was similar to an older plugin that was found on github here.
Now that we have the core functionality working, in future versions we can detach it from the ZFS over iscsi / ZFS pool plugin and put in in our custom plugin.