To run Kubernetes in a production environment, multiple servers are typically required to serve as nodes in a cluster. However, for learning purposes and local development, we can create a Kubernetes environment on our personal machine by partitioning our own hard disk to function as virtual nodes. This can be accomplished using Minikube, a tool specifically designed for this purpose.
Minikube is a lightweight software program that allows us to run a complete Kubernetes cluster on a personal device or computer with a single node. This makes it an ideal solution for developers who want to learn Kubernetes concepts, test applications, or develop containerized services without the need for expensive cloud infrastructure or multiple physical machines. To install and run Minikube on your system, follow the comprehensive steps outlined below.
Requirements Before Starting
Before installing Minikube, ensure that your system meets the following prerequisites:
- Kubectl - The Kubernetes command-line tool that allows you to run commands against Kubernetes clusters. Install it from here.
- Docker - A container runtime that Minikube uses to run Kubernetes components. Install it from here.
Additionally, your system should have at least 2GB of free memory and 20GB of free disk space for optimal performance. Virtualization must also be enabled in your system's BIOS settings.
Installing Minikube
The installation process varies depending on your operating system. Follow the instructions for your specific platform below.
Linux
For Linux systems, download and install Minikube using the following commands in your terminal:
$ curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
$ sudo install minikube-linux-amd64 /usr/local/bin/minikube
After installation, you can verify that Minikube was installed correctly by running minikube version.
Mac
For macOS systems, download and install Minikube with these commands:
$ curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64
$ sudo install minikube-darwin-amd64 /usr/local/bin/minikube
Alternatively, if you have Homebrew installed, you can simply run brew install minikube for a more streamlined installation process.
Windows
For Windows systems, follow these steps:
- Download the Minikube installer for Windows from here.
- Add the Minikube binary to your system path by running PowerShell as Administrator and executing the following commands:
$oldPath = [Environment]::GetEnvironmentVariable('Path', [EnvironmentVariableTarget]::Machine)
if ($oldPath.Split(';') -inotcontains 'C:\minikube'){ `
[Environment]::SetEnvironmentVariable('Path', $('{0};C:\minikube' -f $oldPath), [EnvironmentVariableTarget]::Machine) `
}
After adding Minikube to your path, restart your PowerShell window for the changes to take effect.
Running the Minikube Cluster
Once Minikube is installed, you can start your local Kubernetes cluster. Open a terminal or command prompt with administrator privileges (but not as root user on Linux/Mac) and run:
$ minikube start
This command will download the necessary Kubernetes components, configure your local environment, and start a single-node Kubernetes cluster. The first time you run this command, it may take several minutes to complete as it downloads container images and sets up the cluster. You'll see output indicating the progress of the cluster startup process.
Once the cluster is running, you can verify its status by running kubectl get nodes, which should display your single Minikube node in a "Ready" state.
Stopping the Minikube Cluster
When you're finished working with your local Kubernetes cluster, you can stop it to free up system resources:
$ minikube stop
This command gracefully shuts down the cluster while preserving your configurations and deployed applications. You can restart the cluster later with minikube start without losing your work.
Additional Tips and Tools
Beyond basic start and stop operations, Minikube offers several useful features. You can access the Kubernetes dashboard, a web-based UI for managing your cluster, by running minikube dashboard. This provides a visual interface for monitoring pods, services, and other Kubernetes resources.
We can also operate Minikube through Lens, a powerful GUI application for Kubernetes that provides advanced monitoring, debugging, and management capabilities. Lens offers a more comprehensive visual interface compared to the standard Kubernetes dashboard and is particularly useful for developers who prefer graphical tools over command-line interfaces.
