System Requirements

This section includes detailed system requirements for seamless deployment and optimal performance of Portworx CSI in your Kubernetes environment. Portworx CSI can also run on a single-node Kubernetes cluster. All nodes and back-end storage systems must meet the following requirements:

Hardware requirements

Category	Requirement
CPU	1 CPU
RAM	2 GB minimum
Operating System Root Partition	Minimum: 64 GB Recommended: 128 GB
Network Connectivity	Bandwidth: Recommended: 10 Gbps Minimum: 1 Gbps
Node Type	Bare metal or virtual machine (VM)

Cluster node requirements

note

PX-CSI supports Secure Boot-enabled environments and does not require additional configuration.

FlashArray block volumes

Category	Requirement
Packages	Ensure that the latest versions of the following packages are installed on nodes where you plan to run PX-CSI: RHEL iscsi-initiator-utils device-mapper-multipath kpartx (installed as part of device-mapper-multipath) util-linux cryptsetup (optional, required only for volume encryption) Ubuntu open-iscsi multipath-tools kpartx (installed as part of device-mapper-multipath) util-linux cryptsetup (optional, required only for volume encryption) Debian open-iscsi multipath-tools kpartx (installed as part of multipath-tools) util-linux cryptsetup (optional, required only for volume encryption) SUSE Linux Enterprise Server open-iscsi multipath-tools kpartx (installed as part of multipath-tools) util-linux cryptsetup (optional, required only for volume encryption) Note: For NVMe-oF/TCP protocol with DM-multipath, you need multipath version 0.8.7 or later. Native NVMe Multipath does not require DM-multipath.
NVMe multipath	PX-CSI automatically detects and supports both Native NVMe Multipath and DM-multipath for NVMe protocols. No configuration is required. Native NVMe Multipath: Enabled when nvme_core.multipath=Y. Provides faster failover and improved performance on modern Linux distributions. DM-multipath: Used when nvme_core.multipath=N or on older kernels without native multipath support. PX-CSI automatically discovers the correct device path based on the active multipath mode. For more information about multipath support with FlashArray, see Native Multipath Configuration.
Red Hat systems	Ensure that the second action, CAPACITY_DATA_HAS_CHANGED, is uncommented in the 90-scsi-ua.rules file, and restart the udev service.
CSI snapshot feature	Install the Snapshot controller and deploy the CRDs available here in your Kubernetes cluster.
FC protocol (optional)	If you are using the FC protocol, ensure that the latest FC initiator software is installed.
NVMe CLI (optional)	If you are using the NVMe protocol, ensure that the following NVMe CLI version is installed: RHEL earlier than 9.4/Ubuntu earlier than 22.04: NVMe CLI version 1.16 RHEL 9.4 to 9.5/Ubuntu 22.04 or later: NVMe CLI version 2.6 RHEL 9.6 or later: NVMe CLI version 2.11

FlashArray File Services / FlashBlade

NFS utilities — Ensure that the latest version of NFS utilities is installed on all nodes, including the master node.

Network requirements

PX-CSI supports IPv4, IPv6, and dual-stack configuration for networking.

FlashArray

• Synchronize all cluster nodes using the Network Time Protocol (NTP). Time skew between nodes can cause unexpected behavior or service disruptions.
• Ensure the FlashArray management IP address is accessible by all nodes.
• Verify that your cluster has an operational FlashArray with an existing data plane connectivity layout.
• Use one of the following storage networking protocols supported by Portworx CSI:
  • iSCSI: For block storage over IP networks.
  • NVMe-oF RoCE or NVMe-oF TCP: For high-performance and low-latency storage access.
  • Fibre Channel (FC): For dedicated storage area networks.
• If using iSCSI:
  • Ensure that the storage node iSCSI initiators are on the same VLAN as the FlashArray iSCSI target ports.
  • If using multiple network interface cards (NICs) to connect to an iSCSI host, ensure that all NICs can access the FlashArray data IP address. For multi-subnet environments with network policies that restrict cross-subnet communication, consider using subnet-aware iSCSI login. For more information, see Configure subnet-aware iSCSI login.
• If using Fibre Channel:
  • Ensure that the storage node Fibre Channel WWNs are correctly zoned to the FlashArray Fibre Channel WWN ports.
• Add the following PX-CSI telemetry endpoints on port 443 to networking allow list:
  • https://rest.cloud-support.purestorage.com
  • https://register.cloud-support.purestorage.com

FlashBlade

• Synchronize all cluster nodes using the Network Time Protocol (NTP). Time skew between nodes can cause unexpected behavior or service disruptions.
• Ensure FlashBlade is accessible as a shared resource from all cluster nodes.
• Verify that both the NFSEndPoint and MgmtEndPoint IP addresses are reachable from all nodes.
• Add the following PX-CSI telemetry endpoints on port 443 to networking allow list:
  • https://rest.cloud-support.purestorage.com
  • https://register.cloud-support.purestorage.com

Compatibility and interoperability matrix

For information about supported Kubernetes platforms and distributions, compatible PX-CSI and Portworx Operator versions, minimum Purity version requirements, and supported features per backend, see the Compatibility and Interoperability Matrix.