Skip to content

Upgrade Pachyderm

Upgrades between minor releases or patch releases, such as 2.1.0 to version 2.2.0, should be seamless. Therefore, the upgrade procedure is simple and requires little to no downtime. As a good practice, we recommend that you check the release notes before an upgrade to get an understanding of the changes introduced between your current version and your target.


Do not use these steps to upgrade between major versions as it might result in data corruption.

Complete the following steps to upgrade Pachyderm from one minor release to another.

1- Backup Your Cluster

As a general good practice, start with the backup of your cluster as described in the Backup and Restore section of this documentation.

2- Update Your Helm Values

This phase depends on whether you need to modify your existing configuration (for example, enter an enterprise key, plug an identity provider, reference an enterprise server, etc...).

In the case of a simple upgrade of version on a cluster, and provided that you do not need to change any additional configuration, no change in the values.yaml should be required. The new version of Pachyderm will be directly set in the helm upgrade command.

3- Upgrade pachctl Version

  • To update to the latest version of Pachyderm, run the steps below depending on your operating system:

    • For macOS, run:
    brew tap pachyderm/tap && brew install pachyderm/tap/pachctl@2.3  
    • For a Debian-based Linux 64-bit or Windows 10 or later running on
    curl -o /tmp/pachctl.deb -L && sudo dpkg -i /tmp/pachctl.deb  
    • For all other Linux flavors:
    curl -o /tmp/pachctl.tar.gz -L && tar -xvf /tmp/pachctl.tar.gz -C /tmp && sudo cp /tmp/pachctl_2.3.5_linux_amd64/pachctl /usr/local/bin  


For a specific target release, specify the targeted major/minor version of pachctl for brew and major/minor/patch release for curl in the commands above.

  • Verify that the installation was successful by running pachctl version --client-only:

    pachctl version --client-only  

    System Response:

    COMPONENT           VERSION  
    pachctl             <This should display the version you installed>  

4- Helm Upgrade

  • Redeploy Pachyderm by running the helm upgrade command with your updated values.yaml:

    helm repo add pach
    helm repo update
    helm upgrade pachd -f my_pachyderm_values.yaml pach/pachyderm --version <your_chart_version>


Each chart version is associated with a given version of Pachyderm. You will find the list of all available chart versions and their associated version of Pachyderm on Artifacthub.

  • The upgrade can take some time. You can run kubectl get pods periodically in a separate tab to check the status of the deployment. When Pachyderm is deployed, the command shows all pods as READY:

    kubectl get pods
    Once the pods are up, you should see a pod for pachd running (alongside etcd, pg-bouncer, postgres, console etc... depending on your installation).

    System response:

    NAME                     READY     STATUS    RESTARTS   AGE
    pachd-3677268306-9sqm0   1/1       Running   0          4m
  • Verify that the new version has been deployed:

    pachctl version

    System response:

    pachctl             2.3.5
    pachd               2.3.5

    The pachd and pachctl versions must both match the new version.

Last update: July 23, 2022
Does this page need fixing? Edit me on GitHub