PX CLI Release Notes

PX CLI is a unified command-line interface for secure, remote access to all Portworx services. You can manage Portworx Enterprise, PX-CSI and Portworx Backup clusters without SSH access to nodes, using TLS-encrypted connections and native Kubernetes RBAC integration. The CLI supports multiple output formats and runs as either a standalone binary (px) or a kubectl plugin (kubectl px).

If you’re setting up PX CLI for the first time, see Install PX CLI. If you already use PX CLI, upgrade to the latest version. For upgrade instructions, see Upgrade PX CLI.

PX CLI 1.3.0

June 1, 2026

What's new

Portworx Backup

This release adds support for Cluster Discovery Configs, Azure Workload Identity (WLI) authentication for backup locations, and expanded federated deployment controls for backup location and cluster management.

• ClusterDiscoveryConfig management: Added a new clusterdiscoveryconfig resource (alias: cdc) to pxb create, pxb delete, and pxb get for automated cluster discovery. A new pxb trigger command lets you manually trigger cluster discovery or credential refresh for a config. For more information, see px pxb create, px pxb delete, px pxb get, and px pxb trigger.

• Azure Workload Identity (WLI) for backup locations: The pxb create backuplocation and pxb update backuplocation commands now support Azure WLI authentication mode via the --use-workload-identity flag, which removes the requirement for a cloud credential. Use the --azure-account-name, --azure-subscription-id, --cluster-refs, and --cluster-refs-file flags to configure federated cluster references. For more information, see px pxb create backuplocation and px pxb update backuplocation.

• Federated backup location sync: The pxb create backuplocation and pxb update backuplocation commands now support triggering a backup sync from the object store in federated PX-Backup deployments using the --sync flag. For more information, see px pxb update.

• Targeted backup location validation: pxb validate backuplocation now accepts the --cluster-refs and --cluster-refs-file flags to validate specific clusters instead of all associated clusters. For more information, see px pxb validate.

• Force-delete backup: pxb delete backup now supports metadata-only deletion using the --force flag when no valid cluster is available (federated mode only). Note: This does not remove backup data from object storage. You must clean up the data manually. For more information, see px pxb delete.

• Enhanced cluster listing: pxb get cluster now supports the --cluster-status, --only-backup-share, --project-names, --cluster-discovery-config-refs, --sort-by, --sort-order, --max-objects, and --object-index flags for additional filtering, sorting, and pagination options. For more information, see px pxb get cluster.

PX-CSI

• Storage backend realm support: px csi create backend now supports specifying an optional realm name using the --realm flag when registering a new storage backend. For more information, see px csi create backend.

PX CLI 1.2.0

March 18, 2026

What's new

This release introduces several enhancements to Portworx Backup (pxb) operations, including standardized enumeration filters, granular restore capabilities, and expanded scheduling policies.

• Enumerate filters: Added standardized pagination, sorting, and time-based filtering for VRO, BackupLocation, and CloudCredential commands. For more information, see the px pxb command reference.

• Granular restore: Enhanced pxb create restore with namespace and VM-level filtering, namespace mapping, and resource-level inclusion/exclusion controls. For more information, see px pxb create restore.

• Single file restore: Added support for restoring individual files from VM and volume backups using the --is-sfr flag. For more information, see px pxb create restore.

• Backup resource detail: Enhanced pxb get backupResourceDetail with --force-resync and --sync-namespaces-only operations. For more information, see px pxb get.

• Backup schedule labels: Added namespace and resource-level label selectors to pxb update backupschedule. For more information, see px pxb update.

• Schedule policy enhancements: Expanded pxb create schedulepolicy with bi-weekly, monthly selective date, and monthly relative day scheduling options. For more information, see px pxb create schedulepolicy.

PX CLI 1.1

February 25, 2026

What's new

• Added support for PX-CSI management:
  PX CLI now includes a new px csi component for managing PX-CSI clusters running version 25.8.1 or later. You can create, delete, and list storage backends, and manage CSI-specific resources such as volumes and snapshots.
  For more information about using PX CLI to manage your PX-CSI cluster, see:
  • Connect your PX-CSI cluster
  • px csi command reference

PX CLI 1.0

November 24, 2025

This release includes support for Portworx Enterprise management (px pxe), Portworx Backup operations (px pxb), and legacy pxctl compatibility (px pxctl).

To get started with PX CLI, see the following pages:

1. Learn about PX CLI architecture and benefits
2. Install and Run PX CLI