Skip to main content
Version: 3.2

Portworx node labels

Portworx service and node configuration can be managed through Kubernetes node labels, allowing control over where Portworx is installed, and whether specific nodes should be designated as storage or metadata nodes. Below is a list of common Kubernetes node labels used for managing Portworx service behavior and node designation.

LabelDescription
px/enabled=falsePrevents Portworx from being installed on a node.
px/enabled=trueAllows Portworx to be installed on the node. This is the default behavior if no label is applied.
px/enabled=removeRemoves Portworx from a node. After Portworx is removed, the label is converted to px/enabled=false.
px/service=stopStops the Portworx service on a node.
px/service=startStarts the Portworx service on a node.
px/service=restartRestarts the Portworx service on a node.
px/storage-node=true or falseIndicates whether a node is eligible to become a storage node. Note that this does not guarantee the node will become one. StorageCluster settings take precedence.
px/metadata-node=true or falseIndicates whether a node is eligible to become a KVDB (metadata) node. It does not guarantee that the node will become one.
portworx.io/node-type=storagelessFor disaggregated installs, labels the node as part of the storageless node group.
portworx.io/node-type=storageFor disaggregated installs, labels the node as part of the storage node group.