Skip to main content
Version: Next

Setup Minikube

Minikube is a great tool for emulating a Kubernetes cluster on a single machine. It can also be used to deploy Katonic 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 Katonic, we will use Minikube to emulate a cluster on your machine. We will also need to provide the resources for Katonic 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 Katonic, 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


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 Katonic app or running Katonic jobs.

Follow this guide to complete the setup.

Advanced Information#

Stop the Cluster#

When you want to close down your Minikube deployment of Katonic 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 Katonic deployment use the following command:

minikube delete