Minikube

Learn how to install Pachyderm locally with Minikube.

December 5, 2022

Minikube is a tool that quickly sets up a local Kubernetes cluster on macOS, Linux, and Windows. It’s a great solution for trying out Pachyderm locally.

Before You Start #

Operating System:

1. Install Docker #

brew install docker

See the official Docker getting started guide for the most up-to-date installation steps.

2. Install & Start Minikube #

Install #

brew install minikube

See the official Minikube getting started guide for the most up-to-date installation steps.

Start #

  1. Launch Docker Desktop.
  2. Start Minikube:
minikube start

3. Install Pachctl CLI #

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

4. 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.

5. Verify Installation #

  1. Run the following command in a new terminal to check the status of your pods:
kubectl get po -A
NAMESPACE              NAME                                         READY   STATUS    RESTARTS        AGE
default                console-6b9bb8766d-f2gm4                     1/1     Running   0             41m
default                etcd-0                                       1/1     Running   0             41m
default                pachd-76896d6b5d-kmfvw                       1/1     Running   0             41m
default                pachd-loki-0                                 1/1     Running   0             41m
default                pachd-promtail-rm5ss                         1/1     Running   0             41m
default                pachyderm-kube-event-tail-b9b554fb6-dpcsr    1/1     Running   0             41m
default                pg-bouncer-5c9494c678-z57qh                  1/1     Running   0             41m
default                postgres-0                                   1/1     Running   0             41m
kube-system            coredns-6d4b75cb6d-jnl5f                     1/1     Running   3 (42m ago)   97d
kube-system            etcd-minikube                                1/1     Running   4 (42m ago)   97d
kube-system            kube-apiserver-minikube                      1/1     Running   3 (42m ago)   97d
kube-system            kube-controller-manager-minikube             1/1     Running   4 (42m ago)   97d
kube-system            kube-proxy-bngzv                             1/1     Running   3 (42m ago)   97d
kube-system            kube-scheduler-minikube                      1/1     Running   3 (42m ago)   97d
kube-system            storage-provisioner                          1/1     Running   5 (42m ago)   97d
kubernetes-dashboard   dashboard-metrics-scraper-78dbd9dbf5-swttf   1/1     Running   3 (42m ago)   97d
kubernetes-dashboard   kubernetes-dashboard-5fd5574d9f-c7ptx        1/1     Running   4 (42m ago)   97d
  1. Re-run this command after a few minutes if pachd is not ready.

6. 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