# Minikube

# Installation

Minikube(opens new window) is a tool that makes it easy to run Kubernetes locally. Minikube runs a single-node Kubernetes cluster inside a VM on your laptop for users looking to try out Kubernetes or develop with it day-to-day.

Along with minikube, kubectl(opens new window) CLI client is needed. The installation steps cover how to install it.

For more details on the installation process check documentation of minikube(opens new window) and kubectl(opens new window) .

# Verify Installation

In order to check installation do:

# Verify minikube
> minikube version
minikube version: v0.28.0
# verify kubectl
> kubectl version --client
Client Version: version.Info{Major:"1", Minor:"11", GitVersion:"v1.11.0", GitCommit:"91e7b4fd31fcd3d5f436da26c980becec37ceefe", GitTreeState:"clean", BuildDate:"2018-06-27T22:30:22Z", GoVersion:"go1.10.3", Compiler:"gc", Platform:"darwin/amd64"}

Minikube and kubectl should respond with their respective versions.

# Start Cluster

To start a kubernetes cluster:

> minikube start
Starting local Kubernetes v1.10.0 cluster...
Starting VM...
Getting VM IP address...
Moving files into cluster...
Setting up certs...
Connecting to cluster...
Setting up kubeconfig...
Starting cluster components...
Kubectl is now configured to use the cluster.
Loading cached images from config file.

Once the cluster is up and running you should be able to get the list of nodes through kubectl CLI:

> kubectl get nodes
minikube   Ready     master    22m       v1.10.0


Now you have a working Kubernetes cluster running locally using minikube and have proper authentication using kubectl to connect to the cluster you can proceed to Kubernetic Installation guide.