Run Commands

On-Prem Deploy

Learn how to install on your premises.

Before you start #

Before you can deploy Pachyderm, you will need to perform the following actions:

  1. Install kubectl
  2. Install Helm
  3. Deploy Kubernetes on-premises.
  4. Deploy two Kubernetes persistent volumes for Pachyderm metadata storage.
  5. Deploy an on-premises object store using a storage provider like MinIO, EMC’s ECS, or SwiftStack to provide S3-compatible access to your data storage.
  6. Install PachCTL and PachCTL Auto-completion.

How to Deploy Pachyderm On-Premises #

1. Install Pachyderm via Helm #

helm repo add pachyderm
helm repo update

2. Configure Helm Values #

View and copy a full helm chart from GitHub or ArtifactHub for reference when configuring your Helm values file. You can quickly explore the options for different sections of the Helm chart from our Helm series documentation.

Add Storage classes to Helm Values #

Update your Helm values file to include the storage classes you are going to use:

  storageClass: MyStorageClass
  size: 10Gi

    storageClass: MyStorageClass
    size: 10Gi

Size & Configure Object Store #

  1. Determine the endpoint of your object store, for example minio-server:9000.
  2. Choose a unique name for the bucket you will dedicate to Pachyderm.
  3. Create a new access key ID and secret key for Pachyderm to use when accessing the object store.
  4. Update the Pachyderm Helm values file with the endpoint, bucket name, access key ID, and secret key.
    backend: minio
      endpoint: minio-server:9000
      bucket: pachyderm-bucket
      id: pachyderm-access-key
      secret: pachyderm-secret-key
      secure: false

Configure Authentication & Authorization #

To set up Authentication, you must use the Enterprise version of Pachyderm and provide a valid license key.

We recommend that you create a secret and provide it on the Helm chart as the value to the attribute pachd.enterpriseLicenseKeySecretName. Once deployed, Pachyderm stores your provided Enterprise license as the platform secret pachyderm-license in the key enterprise-license-key.


After deploying Pachyderm, you can log in as the root user and begin to add users to certain resource types such as Projects and Repos.

pachctl auth set project <project-name> <role-name> user:<>

For more information on user permissions, see the Authorization section.

3. Deploy #

helm install pachyderm -f values.yaml pachyderm/pachyderm --version <your_chart_version>

You can update your Helm values file using the following command:

helm upgrade pachyderm pachyderm/pachyderm -f values.yml