$linuxjunkies
>

minikube(1)

minikube is a tool that runs a single-node Kubernetes cluster locally for development and testing.

UbuntuDebianFedoraArch

Synopsis

minikube [COMMAND] [OPTIONS]

Description

minikube starts a local Kubernetes cluster on your machine, simulating a multi-node environment on a single system. It supports multiple container runtimes (Docker, containerd, KVM) and hypervisors, making it ideal for developing and testing Kubernetes applications without cloud resources.

The cluster runs in a VM or container and includes kubectl integration, persistent volumes, and networking. minikube is commonly used for local development, CI/CD testing, and learning Kubernetes fundamentals.

Common options

FlagWhat it does
startCreate and start a local Kubernetes cluster
stopStop a running cluster without deleting it
deleteDelete the local Kubernetes cluster and all data
--driver=DRIVERSpecify container runtime (docker, kvm2, hyperkit, virtualbox, podman)
--cpus=COUNTNumber of CPUs to allocate to the cluster (default: 2)
--memory=SIZEAmount of RAM to allocate, e.g., 2048mb, 2gb (default: 2gb)
--kubernetes-version=VERSIONKubernetes version to install (default: latest stable)
dashboardOpen the Kubernetes dashboard in your browser
logsShow cluster logs for debugging
--addons=LISTEnable addons like ingress, metrics-server, dashboard

Examples

Start a new local Kubernetes cluster with default settings (2 CPUs, 2GB RAM)

minikube start

Start cluster using Docker driver with 4 CPUs and 4GB of memory

minikube start --driver=docker --cpus=4 --memory=4gb

Start a cluster with a specific Kubernetes version

minikube start --kubernetes-version=v1.27.0

Pause the running cluster (data is preserved; restart with 'minikube start')

minikube stop

Open the Kubernetes web dashboard in your default browser

minikube dashboard

SSH into the minikube node for debugging

minikube ssh

Enable the Ingress addon to test ingress controllers

minikube addons enable ingress

Fully reset the cluster: delete old one and start fresh

minikube delete && minikube start

Related commands