Skip to main content
Version: 3.1

Prerequisites for OpenShift Container Platform

Environment Prerequisites

The minimum supported size for a Portworx cluster is three nodes. Each node must meet the following hardware, software, and network requirements:

CPU4 cores minimum, 8 cores recommended
RAM4GB minimum, 8GB recommended
  • /var
  • /opt
  • 2GB free
  • 3GB free
Backing drive8GB (minimum required)
128 GB (minimum recommended)
Operating system root partition64 GB is the minimum required size for the root filesystem which contains the operating system
128 GB minimum recommended
Storage drivesStorage drives must be unmounted block storage: raw disks, drive partitions, LVM, or cloud block storage.
Network connectivityBandwidth:
  • 10 Gbps recommended
  • 1 Gbps minimum

Latency requirements for synchronous replication: less than 10ms between nodes in the cluster
Node typeVirtual machine (VM)
Open ports neededPortworx requires different open ports depending on how it's installed:
  • Portworx on OpenShift 4+ requires open TCP ports at 17001-17020 and an open UDP port at 17002.
  • Telemetry components require the following open ports: 9024, 12001, and 12002.
    • If you are on Portworx version 2.13.7 and older, open port 9024 for telemetry.
    • If you are on Portworx version 2.13.8 and newer, use port 9029 for telemetry.
    Ensure you are running Portworx Operator version 23.7.0 and higher to configure this port for Telemetry.
  • Portworx also requires an open KVDB port. For example, if you're using etcd externally, open port 2379.
  • If you intend to use Portworx with sharedv4 volumes, you may need to open your NFS ports.
Domain AllowlistingFor environments with locked down network connectivity, Portworx requires different domains to be allowlisted depending on how it's installed:
    Telemetry requires the following domains to be allowlisted:
  •, and
Linux kernel and distroKernel version 3.10 or greater.
To check if your Linux distro and kernel are supported, see Supported Kernels.
Key-value storePortworx needs a key-value store to perform its operations. As such, install a clustered key-value database (kvdb) with a three node cluster.

You can also use Internal KVDB during installation. In this mode, Portworx will create and manage an internal key-value store (KVDB) cluster.

If you plan of using your own KVDB, refer to KVDB for Portworx for details on recommendations for installing and configuring a KVDB cluster.
Disable swapPlease disable swap on all nodes that will run the Portworx software. Ensure that the swap device is not automatically mounted on server reboot.

Portworx network requirements


Portworx also requires an open KVDB port. For example, if you're using etcd externally, open port 2379.

Portworx ports for east to west traffic

Portworx Enterprise supported versions

Before you install Portworx on Kubernetes, ensure that you're using a supported Kubernetes version:

Supported Kubernetes Version
Red Hat OpenShift:
  • OpenShift 4.12: Kubernetes version 1.25 (OpenShift version verified up to 4.12.44)
  • OpenShift 4.13: Kubernetes version 1.26 (OpenShift version verified up to 4.13.35)
  • OpenShift 4.14: Kubernetes version 1.27 (OpenShift version verified up to 4.14.15)
  • OpenShift 4.15: Kubernetes version 1.28 (OpenShift version verified up to 4.15.3)
  • Supports both bare metal and VM
  • For OpenShift 4.14, Operator 23.10.4 or newer is required
Was this page helpful?