Run Commands

First-Time Setup

Pachyderm can be deployed in Kubernetes using a wide variety of container orchestrators, but to get you set up for the very first time, we recommend using Docker Desktop. This installation method is very fast and will provide you with everything you need to start the Beginner Tutorial.

Before You Start #

Operating System:

1. Install Docker Desktop #

  1. Install Docker Desktop for your machine.
  2. Navigate to Settings for Mac, Windows, or Linux.
  3. Select Apply & Restart.

2. Install Pachctl CLI #

Operating System:

3. Install & Configure Helm #

  1. Install Helm:
brew install helm
  1. Add the Pachyderm repo to Helm:
helm repo add pachyderm  
helm repo update  
  1. Install PachD:

This may take several minutes to complete.

4. Verify Installation #

  1. In a new terminal, run the following command to check the status of your pods:
kubectl get pods
NAME                                           READY   STATUS      RESTARTS   AGE
pod/console-5b67678df6-s4d8c                   1/1     Running     0          2m8s
pod/etcd-0                                     1/1     Running     0          2m8s
pod/pachd-c5848b5c7-zwb8p                      1/1     Running     0          2m8s
pod/pg-bouncer-7b855cb797-jqqpx                1/1     Running     0          2m8s
pod/postgres-0                                 1/1     Running     0          2m8s
  1. Re-run this command after a few minutes if pachd is not ready.

5. Connect to Cluster #

pachctl connect http://localhost:80 

If the connection commands did not work together, run each separately.

Optionally open your browser and navigate to the Console UI.


You can check your Pachyderm version and connection to pachd at any time with the following command:

pachctl version

pachctl             2.6.1  
pachd               2.6.1