# Set up a Minikube Cluster

Minikube is a great tool for emulating a Kubernetes cluster on a single machine. It can also be used to deploy cnvrg and see it in action.

In this guide, you will learn how to:

  • Create a Minikube Kubernetes cluster

# Prerequisites: prepare your local environment

Before you can complete the installation you must install and prepare the following dependencies on your local machine:

# Set Minikube to Use Certificates for Authentication

By default, a Minikube cluster is virtually unreachable beyond your machine. In order, to allow for authenticated access to the Minikube cluster, run the following command:

minikube config set embed-certs true

# Launch a Minikube Cluster

Before we deploy cnvrg, we will use Minikube to emulate a cluster on your machine. We will also need to provide the resources for cnvrg to be able to run. Use the following command to start Minikube accordingly:

minikube start --cpus=10 --memory=8000  --disk-size='50000mb'

NOTE

Make sure your Minikube cluster is running Kubernetes version 1.16.8 or earlier. 1.17 is not currently supported.

If your machine has a GPU and you would like to use it as part of cnvrg, follow this guide to enable GPU support in your Minikube cluster.

# Check you Minikube cluster is Running

Before you continue with the installation, check that your Minikube cluster was started successfully by running the minikube status:

minikube status

The response for the above command should be:

host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

# Conclusion

Congratulations, you have now set up a working Minikube cluster! You can now use Helm to finish the setup and get the cluster ready to be used for deploying the cnvrg app or running cnvrg jobs.

Follow this guide to complete the setup.

# Advanced Information

# Stop the Cluster

When you want to close down your Minikube deployment of cnvrg and free up your resources use the following command:

minikube stop

# Delete the Cluster

If you would like to delete the cluster and remove all the traces of the cnvrg deployment use the following command:

minikube delete
Last Updated: 7/9/2020, 11:03:11 AM