Minikube — Run Kubernetes Locally on Any OS

What it is

Minikube runs a local Kubernetes cluster on your laptop. It creates a single-node cluster using Docker, VirtualBox, or other VM drivers, giving you a fully functional Kubernetes environment for development and testing. Minikube supports the latest Kubernetes features, add-ons like ingress and metrics-server, and a built-in dashboard.

Minikube targets developers learning Kubernetes, teams testing K8s deployments locally before pushing to production, and CI pipelines that need a disposable Kubernetes environment.

How it saves time or tokens

Minikube eliminates the need for cloud Kubernetes clusters during development. One command starts a local cluster with configurable CPU and memory. Built-in add-ons (ingress, metrics-server, dashboard) activate with a single flag instead of manual installation. The minikube tunnel command exposes LoadBalancer services locally, and minikube mount shares local directories into the cluster.

How to use

1. Install Minikube: brew install minikube on macOS, or download from the Minikube releases page.
2. Start a cluster: minikube start --driver=docker --cpus=4 --memory=8g.
3. Use kubectl as normal: kubectl get nodes, deploy applications, and test.

Example

# Install and start
brew install minikube
minikube start --driver=docker --cpus=4 --memory=8g

# Verify
kubectl get nodes

# Enable useful add-ons
minikube addons enable ingress
minikube addons enable metrics-server

# Open the dashboard
minikube dashboard

# Deploy an app
kubectl create deployment hello --image=nginx
kubectl expose deployment hello --type=NodePort --port=80
minikube service hello

# Clean up
minikube stop
minikube delete

Related on TokRepo

• DevOps Tools — Kubernetes and infrastructure tools
• Automation Tools — Development environment automation

Common pitfalls

• Minikube runs a single-node cluster. Multi-node features (node affinity, pod anti-affinity, cluster scaling) behave differently than in production multi-node clusters.
• Resource allocation matters. Setting too little CPU or memory causes pod scheduling failures and OOM kills. Start with at least 2 CPUs and 4GB RAM.
• Docker driver is recommended over VirtualBox for better performance and compatibility. Ensure Docker Desktop is running before starting Minikube.