Kubernetes Minikube installieren: Einfach erklärt

Stand: 14.10.2026

Kubernetes mit Minikube zu installieren ist ein guter Weg, um Container-Orchestrierung lokal und ohne Cloud-Konto zu lernen. Du startest ein einzelnes Kubernetes-Cluster auf deinem Rechner, steuerst es mit kubectl und kannst Anwendungen gefahrlos ausprobieren. Diese Anleitung zeigt den sauberen Einstieg mit dem Docker-Treiber.

Auf einen Blick

• Minikube erstellt ein lokales Kubernetes-Cluster für Entwicklung und Lernen.
• Du brauchst mindestens zwei CPU-Kerne, 2 GB freien Arbeitsspeicher und 20 GB Speicherplatz.
• kubectl ist das Kommandozeilenwerkzeug für Ressourcen und Status im Cluster.
• Mit dem Docker-Treiber vermeidest du für viele lokale Setups eine zusätzliche VM.

Was ist Kubernetes und wofür ist Minikube gedacht?

Kubernetes verwaltet containerisierte Anwendungen. Es plant Container als Pods ein, hält die gewünschte Anzahl verfügbar und stellt Netzwerkzugriffe bereit. Dadurch beschreibst du den Zielzustand deiner Anwendung, statt einzelne Container dauerhaft manuell zu starten.

Minikube bringt diese Konzepte auf einen einzelnen Computer. Es ist daher sinnvoll für Tutorials, lokale Entwicklung und das Testen von Manifesten. Für hochverfügbare Produktion oder mehrere Nodes ist Minikube dagegen nicht die passende Plattform. Wenn du zunächst den Unterschied zwischen Orchestrierung und Container-Runtime verstehen willst, hilft auch unser Vergleich Kubernetes vs. Docker Swarm.

Welche Voraussetzungen brauchst du?

Die Minikube-Dokumentation nennt mindestens zwei CPUs, 2 GB freien Arbeitsspeicher, 20 GB freien Speicher sowie eine Container- oder VM-Umgebung. Plane zusätzlich Reserven ein, wenn du mehrere Pods, Images oder ein Dashboard verwendest. Aktiviere Virtualisierung nur dann, wenn dein gewählter Treiber sie benötigt.

Docker sollte vor dem Start laufen. Der Docker-Treiber setzt laut Minikube-Dokumentation Docker 20.10 oder neuer voraus. Verwende möglichst die offiziellen Installationswege deiner Distribution oder des Herstellers, statt einzelne Binärdateien aus unbekannten Quellen zu laden.

Kubernetes Minikube installieren: So gehst du vor

1. Installiere Docker und prüfe, ob die Engine erreichbar ist.
2. Installiere Minikube über die offizielle Minikube-Startanleitung.
3. Installiere kubectl passend zu deinem Betriebssystem über die Kubernetes-Dokumentation.
4. Prüfe beide Programme und starte danach das Cluster mit dem Docker-Treiber.

Unter macOS kannst du Minikube beispielsweise mit Homebrew installieren. Unter Linux und Windows unterscheiden sich Paketnamen und Installationswege. Deshalb verlinkt diese Anleitung bewusst auf die jeweils gepflegten Herstellerbefehle. So übernimmst du keine veraltete Download-URL.

minikube version
kubectl version --client
docker version

Die Ausgaben bestätigen, dass die Programme gefunden werden. Bei Linux muss dein Benutzer außerdem Zugriff auf den Docker-Socket haben. Starte Docker nicht automatisch mit sudo-Befehlen, wenn du später mit dem Docker-Treiber arbeitest; richte die Docker-Berechtigungen stattdessen nach der Dokumentation ein.

Wie startest und prüfst du das lokale Cluster?

Starte Minikube explizit mit dem Docker-Treiber. Das macht die Wahl der lokalen Laufzeitumgebung nachvollziehbar. Beim ersten Start lädt Minikube die nötigen Images, weshalb der Vorgang etwas dauern kann.

minikube start --driver=docker
kubectl get nodes
kubectl get pods -A

Ein Node mit dem Status Ready zeigt, dass die Kubernetes-Steuerung erreichbar ist. Mit kubectl get pods -A siehst du zusätzlich die System-Pods aller Namespaces. Warte bei ContainerCreating kurz und prüfe anschließend erneut, statt sofort neu zu installieren.

Für einen ersten eigenen Test erstellst du ein Deployment und machst es lokal erreichbar. Das Beispiel verwendet ein kleines Webserver-Image und lässt sich danach rückstandslos entfernen.

kubectl create deployment web --image=nginx
kubectl expose deployment web --type=NodePort --port=80
minikube service web --url

Die letzte Zeile liefert eine lokale Adresse. Öffne sie im Browser oder teste sie mit einem geeigneten HTTP-Client. Danach räumst du die Beispielressourcen auf. So bleibt dein Übungscluster übersichtlich.

kubectl delete service web
kubectl delete deployment web

Wann hilft das Dashboard und wann reicht kubectl?

Das Minikube-Dashboard ist eine praktische Ansicht für Nodes, Pods und Deployments. Du startest es mit folgendem Befehl. Minikube öffnet dabei je nach Umgebung einen Browser oder stellt eine lokale URL bereit.

minikube dashboard

Trotzdem solltest du die wichtigsten kubectl-Befehle lernen. Sie funktionieren auch auf entfernten Clustern und passen gut zu deklarativen YAML-Dateien. Für wiederholbare Installationen bieten sich später Helm Charts an. Sobald du Anwendungen beobachten willst, ergänzt du das Setup mit Kubernetes-Monitoring mit Grafana und Prometheus.

Was tun bei typischen Problemen?

Bricht der Start ab, prüfe zuerst den gewählten Treiber, freien Speicher und ob Docker wirklich läuft. Mit minikube status erhältst du eine kompakte Zustandsübersicht. Außerdem zeigt minikube logs die Minikube-Logs, wenn die Ursache nicht sofort erkennbar ist.

minikube status
minikube logs
kubectl cluster-info

Wenn du das lokale Cluster nicht mehr benötigst, stoppe es. Das behält die Konfiguration für einen späteren Start. minikube delete entfernt dagegen das gesamte Profil samt Cluster-Daten; nutze diesen Befehl nur, wenn du wirklich neu beginnen möchtest.

minikube stop
# Nur wenn du das lokale Cluster vollständig löschen willst:
minikube delete

Fazit

Minikube macht Kubernetes lokal verständlich und reproduzierbar. Installiere Docker, Minikube und kubectl über die offiziellen Quellen, starte das Cluster mit einem klar gewählten Treiber und prüfe den Node-Status. Danach kannst du Deployments, Services und später Helm ohne Risiko üben.

Quellen

• Minikube: Get Started
• Minikube: Docker Driver
• Minikube: dashboard command
• Kubernetes: Install Tools

Häufige Fragen