Quick Start with Minikube

To set up and run Meshery on Minikube:

  1. Start Minikube
  2. Configure Meshery to use minkube
  3. Run Meshery


The following minimum component versions are required:

Name Version
Minikube 1.0.0
Kubernetes 1.14.1
kubectl 1.14.1


Perform the following steps in order:

1. Start minikube

minikube start --cpus 4 --memory 8192 --kubernetes-version=v1.14.1

Note: minimum memory required is –memory=4096 (for Istio deployments only)

Note: If you are using docker driver, after completing meshery installation steps execute below command to establish connectivity between Meshery and Kubernetes server.

docker network connect bridge meshery_meshery_1

2. Configure Meshery to use minikube

  1. Login to Meshery. Under your user profile, click Get Token.
  2. Use mesheryctl to configure Meshery to use minikube. Execute:
mesheryctl system config minikube -t ~/Downloads/auth.json

You may also manually generate and load kubeconfig file for Meshery to use:

This configuration file will be used by Meshery.

kubectl config view --minify --flatten > config_minikube.yaml
apiVersion: v1
- cluster:
    certificate-authority-data: < cert shortcutted >
  name: minikube
- context:
    cluster: minikube
    user: minikube
  name: minikube
current-context: minikube
kind: Config
preferences: {}
- name: minikube
    client-certificate-data: <cert shortcutted >
    client-key-data: < key shortcutted >

Note: Make sure current-context is set to minikube.

3. Set up Meshery

Follow the installation steps to install the mesheryctl CLI.

Meshery should now be connected with your managed Kubernetes instance. Take a look at the Meshery guides for advanced usage tips.