System Requirements
Before installing Portworx Enterprise, ensure your environment meets the minimum requirements for a stable and supported deployment. A Portworx cluster must include at least three nodes, each meeting specific hardware, software, and network requirements.
Hardware requirements
Each node in the Portworx cluster must meet baseline hardware specifications. These vary slightly depending on whether you're using PX-StoreV1 or PX-StoreV2. Requirements include CPU, RAM, disk space and storage drive configuration to ensure optimal operation.
- PX-StoreV1
- PX-StoreV2
Hardware | Requirements |
---|---|
CPU | Minimum 4 Cores | Recommended 8 Cores |
RAM | Minimum 4GB | Recommended 8GB |
Disk | /var - Recommended 30GB Free/opt - Minimum 3GB Free |
Backing drive | 8GB (minimum required) 128GB (minimum recommended) |
Operating system root partition | |
Storage drives | Storage drives must be unmounted block storage: raw disks, drive partitions, LVM, or cloud block storage. |
Network connectivity | Bandwidth:
|
Node type | Bare metal and virtual machine (VM) |
Hardware | Requirements |
---|---|
CPU | Minimum 8 Cores | Recommended 16 Cores |
RAM | Minimum 8GB | Recommended 16GB |
Disk | /var - Recommended 20GB Free/opt - Minimum 3GB Free | Recommended 20GB Free |
Backing drive | 8GB (minimum required) 128GB (minimum recommended) |
Operating system root partition | If /opt and /var are created as separate disks then 64 GB is sufficient for root partition. Otherwise minimum 128GB required |
Storage drives | Storage drives must be unmounted block storage: raw disks, drive partitions, LVM, or cloud block storage. |
Network connectivity | Bandwidth:
|
Node type | Bare metal and virtual machine (VM) |
Software requirements
Each node in the Portworx cluster must meet the necessary software requirements, including a supported Linux kernel version, container runtime, and key-value store configuration. Portworx also depends on specific system utilities and settings, such as having swap disabled and NTP enabled, to ensure reliable and consistent cluster behavior.
- PX-StoreV1
- PX-StoreV2
Software | Requirements |
---|---|
Linux kernel and distro | Kernel version 4.18 or greater. |
Docker | Version 1.13.1 or greater. |
Key-value store | Portworx needs a key-value store to perform its operations. As such, install a clustered key-value database
( |
Disable swap | Disable swap on all nodes that will run the Portworx software. Ensure that the swap device is not automatically mounted on server reboot. |
Network Time Protocol (NTP) | All nodes in the cluster should be in sync with NTP time. Any time drift between nodes can cause unexpected behavior, impacting services. |
Software | Requirements |
---|---|
Linux kernel and distro | Linux kernel version: 4.20 or newer (minimum), 5.0 or newer (recommended). During installation, Portworx will automatically try to pull the |
Docker | Version 1.13.1 or greater. |
Key-value store | Portworx needs a key-value store to perform its operations. As such, install a clustered key-value database
( |
Disable swap | Disable swap on all nodes that will run the Portworx software. Ensure that the swap device is not automatically mounted on server reboot. |
Network Time Protocol (NTP) | All nodes in the cluster should be in sync with NTP time. Any time drift between nodes can cause unexpected behavior, impacting services. |
PX-StoreV2 is currently supported on the following platforms.
- Google Cloud Anthos on VMware vSphere
- Google Cloud Anthos with Pure Storage FlashArray Cloud Drives
- Red Hat OpenShift on VMware vSphere
- Red Hat OpenShift with Pure Storage FlashArray Cloud Drives
- Rancher on Ubuntu with VMware vSphere, Pure Storage FlashArray Cloud Drives, and Local Storage
- Rancher on SUSE Linux Enterprise Micro (SLE Micro) with VMware vSphere and Local Storage
- Azure Kubernetes Service (AKS)
- Google Kubernetes Engine (GKE)
Supported hypervisor version
Hypervisor | |
---|---|
VMware vSphere |
|
Network requirements
Portworx runs as a pod in a Kubernetes cluster and requires specific ports to be open for node communication, storage operations, and telemetry. These vary slightly between Kubernetes and OpenShift environments.
East-to-West
Kubernetes | OpenShift | Description |
---|---|---|
9001 | 17001 | Portworx management port [REST] |
9002 | 17002 | Portworx node-to-node port [gossip]/UDP Required open when using external KVDB |
9003 | 17003 | Portworx storage data port |
9004 | 17004 | Portworx namespace [RPC] |
9012 | 17009 | Portworx node-to-node communication port [gRPC] |
9013 | 17010 | Portworx namespace driver [gRPC] |
9014 | 17011 | Portworx diags server port [gRPC] |
9018 | 17015 | Portworx kvdb peer-to-peer port [gRPC] |
9019 | 17016 | Portworx kvdb client service [gRPC] |
9021 | 17018 | Portworx gRPC SDK gateway [REST] |
9022 | 17019 | Portworx health monitor [REST] |
9029 | 17021 | Telemetry log uploader |
12002 | 20002 | Telemetry phone home |
2379 | 2379 | External KVDB (etcd) port Open only if you run an external etcd cluster |
Inbound
Kubernetes | OpenShift | Description |
---|---|---|
9001 | 17001 | Portworx management port [REST] |
9021 | 17018 | Portworx gRPC SDK gateway [REST] |
Outbound
Type | TCP Port(s) | Scope | Destination host(s) | Description |
---|---|---|---|---|
Install / Upgrade | 443 | PX install & version updates | install.portworx.com | Retrieves install spec and helper scripts |
License activation | 443 | PAYG licensing | rest.zuora.com | Usage reporting & license retrieval. Not applicable for air-gapped deployements. |
443 | PAYG licensing | flex1327.compliance.flexnetoperations.com | For licensing to work. Not applicable for air-gapped deployements. | |
Telemetry | 443 | Cluster registration & metrics | register.cloud-support.purestorage.com, rest.cloud-support.purestorage.com | Registers cluster and uploads usage metrics |
443 / 80 | Event log uploads | logs-01.loggly.com | Sends PX log events for support | |
9024 | Portworx version 2.13.7 and older | Telemetry components | Telemetry data channel | |
9029 | Portworx version 2.13.8 and newer | Telemetry components | Telemetry data channel | |
12001 | Collector service | Telemetry components | Aggregates data before upload | |
12002 | Heartbeat / phone-home | Telemetry components | Periodic health-check pings | |
Snapshots / Backups | 443 | CloudSnaps, backups, restores | Your S3 or S3-compatible endpoint | Persist snapshots & object data |
Supported Kubernetes versions
Before you install Portworx on any environment, ensure that you're using a supported environment version:
If your Kubernetes distribution supports multiple Linux distributions and kernel versions, refer to the Supported kernels page to ensure that your kernel version is supported.
- 3.3
- 3.2
- 3.1
- 3.0
Portworx Enterprise 3.3.0 supports Kubernetes version 1.32, starting from version 1.32.2. Before upgrading Kubernetes to 1.32.2 or later, update the Portworx Stork to version 25.2.2 or above and Portworx Operator to 24.2.3 version or above. For more details, refer to the Portworx Operator 24.2.3 release note
Type | Supported Versions |
---|---|
Kubernetes On-prem |
|
Managed Kubernetes distribution |
|
Distribution Kubernetes |
|
Tanzu |
|
Google Anthos |
|
Portworx Enterprise 3.2.2 supports Kubernetes version 1.31, starting from version 1.31.6. Before upgrading Kubernetes to 1.31.6 or later, update the Portworx Operator to version 24.2.3. For more details, refer to the Portworx Operator 24.2.3 release notes.
Type | Supported Versions |
---|---|
Kubernetes On-prem |
|
Managed Kubernetes distribution |
|
Distribution Kubernetes |
|
Tanzu |
|
Google Anthos |
|
Type | Supported Versions |
---|---|
Kubernetes On-prem |
|
Managed Kubernetes distribution |
|
Distribution Kubernetes |
|
Tanzu |
|
Google Anthos |
|
Type | Supported Kubernetes Version |
---|---|
On-prem Kubernetes |
|
Managed Kubernetes |
|
Distribution Kubernetes | Red Hat OpenShift:
NOTE: Supports both bare metal and VM. |
vSphere with Tanzu Kubernetes Grid Service (TKGS) |
|
VMware Tanzu Kubernetes Grid Integrated Edition (TKGI) |
|
Anthos | Bare metal
|
What to do next
You can install Portworx on the cloud or on-premises. Proceed to one of the following sections for Kubernetes and OpenShift install instructions.
📄 Install Portworx on Kubernetes
Learn how to install Portworx with Kubernetes
📄 Install Portworx on OpenShift
Learn how to install Portworx with OpenShift