Instructions for setting up a minikube cluster for Verrazzano

minikube quickly sets up a local Kubernetes cluster on macOS, Linux, and Windows. Follow these instructions to prepare a minikube cluster for running Verrazzano.


  • Install minikube.
  • Install a driver:
    • On macOS or Windows, select a VM-based driver, not Docker.
    • Oracle Linux 7, deploying WebLogic or Coherence applications requires the kvm2 driver because the Docker driver requires a kernel patch.

Prepare the minikube cluster

To prepare the minikube cluster for use with Verrazzano, you must create the cluster and then expose services of type LoadBalancer by using the minikube tunnel command.

Create the minikube cluster

Create a minikube cluster using a supported Kubernetes version and appropriate driver. On Linux hosts, the default driver is acceptable; on macOS, hyperkit is recommended.

$ minikube start \
    --kubernetes-version=v1.18.8 \
    --driver=hyperkit \
    --memory=16G \
    --disk-size=30G \
    --cpus=4 \
    --extra-config=apiserver.service-account-signing-key-file=/var/lib/minikube/certs/sa.key \
    --extra-config=apiserver.service-account-issuer=kubernetes/serviceaccount \

Run minikube tunnel

minikube exposes Kubernetes services of type LoadBalancer with the minikube tunnel command.

Note that the ip command is required by minikube tunnel. You may need to add /sbin to your PATH environment variable.

Run a tunnel in a separate terminal from minikube:

$ minikube tunnel

Next steps

To continue, see the Installation Guide.

Last modified April 12, 2021: re-org TOC/docs (#118) (d00db56)