Docker Desktop

Learn how to install Pachyderm locally with Docker Desktop.

December 5, 2022

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 #

brew tap pachyderm/tap && brew install pachyderm/tap/pachctl@2.4  

3. Install & Configure Helm #

  1. Install Helm:
brew install helm
  1. Add the Pachyderm repo to Helm:
helm repo add pach https://helm.pachyderm.com  
helm repo update  
  1. Install PachD:
Version:

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 #

echo '{"pachd_address":"grpc://127.0.0.1:80"}' | pachctl config set context local --overwrite && pachctl config set active-context local
ℹ️

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
COMPONENT           VERSION  

pachctl             2.4.1  
pachd               2.4.1