Setting a Static IP for a Cluster

Overview

This tutorial will show you how to create a minikube cluster with a static IP.

Prerequisites

  • minikube v1.29.0 or higher
  • Docker or Podman driver

Selecting a static IP

The static IP must be IPv4, private, and the last octet must be between 2-254 (X.X.X.2 - X.X.X.254).

Valid static IPs:
10.0.0.2 - 10.255.255.254
172.16.0.2 - 172.31.255.254
192.168.0.2 - 192.168.255.254

Tutorial

Use the --static-ip flag on minikube start to set the static IP.

Note: You cannot add a static IP to an existing cluster, you have to delete and recreate the cluster with the flag.

  1. $ minikube start --driver docker --static-ip 192.168.200.200
  2. 😄  minikube v1.28.0 on Darwin 13.1 (arm64)
  3. ✨  Using the docker driver based on user configuration
  4. 📌  Using Docker Desktop driver with root privileges
  5. 👍  Starting control plane node minikube in cluster minikube
  6. 🚜  Pulling base image ...
  7. 🔥  Creating docker container (CPUs=2, Memory=4000MB) ...
  8. 🐳  Preparing Kubernetes v1.25.3 on Docker 20.10.21 ...
  9.     ▪ Generating certificates and keys ...
  10.     ▪ Booting up control plane ...
  11.     ▪ Configuring RBAC rules ...
  12. 🔎  Verifying Kubernetes components...
  13.     ▪ Using image gcr.io/k8s-minikube/storage-provisioner:v5
  14. 🌟  Enabled addons: default-storageclass
  15. 🏄  Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default
  17. $ minikube ip
  18. 192.168.200.200

Last modified January 4, 2023: add FAQ and tutorial for static IP (d47bb1a5a)