How to Install and Set Up Kubernetes on Windows, Mac, and Linux: Step-by-Step Guide


Kubernetes installation on all platforms

Kubernetes is a powerful open-source platform for managing containerized workloads and services. This guide will walk you through setting up a local Kubernetes cluster using Minikube on Windows, Mac, and Linux.



Before installing Kubernetes, ensure your system meets the following requirements:

  • A container or virtual machine manager, such as Docker, Hyper-V, or VirtualBox. We recommend using Docker.
  • kubectl: The Kubernetes command-line tool.
  • Minikube: A tool for running a single-node Kubernetes cluster locally.


You need to install `kubectl` to interact with your Kubernetes cluster.

On Windows:

curl -LO "https://dl.k8s.io/release/v1.28.0/bin/windows/amd64/kubectl.exe"
# Add the kubectl binary to your PATH

On macOS:

brew install kubectl

On Linux:

sudo apt-get update && sudo apt-get install -y apt-transport-https
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl


Now, let's install Minikube to create a local Kubernetes cluster.

On Windows (using PowerShell with Administrator privileges):

New-Item -Path 'c:\' -Name 'minikube' -ItemType Directory -Force
Invoke-WebRequest -OutFile 'c:\minikube\minikube.exe' -Uri 'https://github.com/kubernetes/minikube/releases/latest/download/minikube-windows-amd64.exe' -UseBasicParsing
# Add c:\minikube to your PATH

On macOS:

brew install minikube

On Linux:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube


  1. Start Minikube: Open a terminal and run the following command:
  2. minikube start --driver=docker

    This will start a single-node Kubernetes cluster. It might take a few minutes.

  3. Verify Cluster Status: Check the status of your cluster:
  4. minikube status
  5. Interact with the Cluster: You can now use `kubectl` to interact with your cluster. For example, to see the nodes:
  6. kubectl get nodes


Congratulations! You have successfully installed and set up a local Kubernetes cluster on your system. You can now start deploying applications to Kubernetes.



Explore our collection of useful resources and downloads to enhance your experience:

  • Kubernetes Documentation: Access the official Kubernetes documentation for more in-depth information.
  • Minikube Documentation: Learn more about Minikube's features and commands.

FAQ


Q: Can I use Minikube for production?
A: No, Minikube is designed for local development and testing, not for production workloads.


Q: How do I stop the local cluster?
A: You can stop the cluster by running `minikube stop` in your terminal.


Read Next


Subscribe to Our Newsletter

Get the latest updates and exclusive content delivered to your inbox!