Install PX-Central on-premises

You can install PX-Central on-premises on any Kubernetes cluster using Helm charts, as long as your cluster meets the prerequisites.


  • A Kubernetes cluster consisting of the following:

    • 3 worker nodes
    • 4 CPU cores
    • 8 GB of memory
    • A minimum of 1 disk with 100 GB, ideally 2 disks on each node with at least 100 GB each
    • Kubernetes versions 1.22.x and below
    • If you want to use Portworx for the PX-Central installation and your Kubernetes cluster does not contain Portworx, ensure a minimum of 50 GB disk space is available on the /root file system.
    • If you use an external OIDC provider, then you must use certificates signed by a trusted certificate authority.
    • Helm
  • For internet-connected clusters, ensure the following ports are open:

    Port Component Purpose Incoming/Outgoing
    31241 PX-Central-Keycloak Access user auth token Incoming
    7070 License server License validation Outgoing


    • GKE clusters support Ubuntu OS only.

    • PX-Central supports Kubernetes version 1.18.3 and above. If you install PX-Central on Kubernetes version 1.18.2 or below, then Kubernetes does not proxy the service name to the pod resulting in service reachability errors.

    • You can install PX-Central on a Kubernetes cluster that is already running Portworx, or on a fresh Kubernetes cluster that does not contain Portworx.

    • If you want to install the monitoring service component, in addition, you need at least 8 CPU cores and 16 GB of memory.

Install PX-Central on air-gapped clusters

If your cluster is air-gapped, then refer to the Install Px-Central in air-gapped environment for more information about preparing your air-gapped environment and pushing docker images to an internal registry.

Install PX-Central on-premises alone

  1. If you install PX-Central alone – without Portworx Enterprise – skip this step. If you do want to install PX-Central with Portworx Enterprise, then install Portworx and create the following storage class on your Kubernetes cluster.

    kind: StorageClass
        name: portworx-sc
        repl: "3"
  2. Generate the install spec using the License Server and Monitoring spec generator.

    If you use Portworx to install PX-Central alone, select the Use storage class checkbox under the Configuration section of the Spec Details tab. In the Storage Class Name text box, enter the name of the storage class you created in the previous step.

    If your cluster is air-gapped, select the Use custom registry checkbox under the *Custom Registry section, and enter the following information:

    • Custom Registry: The hostname of your custom registry
    • Image Repository: The path to the required Docker images
    • Image Pull Secret(s) (optional): A comma-separated list of your image pull secrets.
  3. Using Helm, add the Portworx Enterprise repository to your cluster and update it.

    helm repo add <repo-name> portworx && helm repo update
  4. Install PX-Central alone using either the --set flag or the values.yml file provided in the Step 2 section of the Complete tab of the spec generator.

  5. Monitor the installation status.

    kubectl get po --namespace px-backup -ljob-name=pxcentral-post-install-hook  -o wide | awk '{print $1, $3}' | grep -iv error

    Note: If you use your Kubernetes master IP as the Keycloak endpoint, then run the following command on all worker nodes:

    sudo iptables -P FORWARD ACCEPT

This enables port forwarding using iptables, making the NodePort service accessible through the master endpoint.

Configure external OIDC endpoints

If you enabled an external OIDC during PX-Central installation, then manually configure the redirect URI in your OIDC provider. For the configuration procedure, refer Set up login redirects.

Last edited: Thursday, Apr 28, 2022