Why Mac Developers Choose kubectl
Many Kubernetes engineers and platform teams run macOS as their daily driver, pairing kubectl with tools like Docker Desktop, Lens, or k9s for a complete local development workflow.
Method 1: Install kubectl with Homebrew
Homebrew is the most popular package manager on macOS and the recommended install method for most users.
- Open Terminal.
- Run
brew install kubectl - Confirm installation with
kubectl version --client
Method 2: Install via curl (Binary Download)
This method works identically across Intel and Apple Silicon Macs, provided you select the correct architecture.
- For Apple Silicon, run
curl -LO "https://dl.k8s.io/release/v1.31.0/bin/darwin/arm64/kubectl" - For Intel Macs, replace
arm64withamd64in the URL. - Make it executable with
chmod +x ./kubectl - Move it into your PATH:
sudo mv ./kubectl /usr/local/bin/kubectl
Method 3: Install via MacPorts
If you use MacPorts instead of Homebrew, run sudo port install kubectl and follow the on-screen prompts.
Verifying the Installation
Run kubectl version --client to confirm the binary is executable and check which version you’ve installed. You can also run which kubectl to confirm the install path.
Setting Up Cluster Access
Your kubeconfig file lives at ~/.kube/config. If you’re using Docker Desktop’s built-in Kubernetes, it automatically merges its context into this file. For cloud providers, use their respective CLI tools (aws eks update-kubeconfig, gcloud container clusters get-credentials, or az aks get-credentials) to populate it automatically.
Apple Silicon Considerations
Older tutorials sometimes reference Intel-only binaries. Always confirm you’re downloading the arm64 build if you’re on an M1, M2, M3, or M4 Mac to avoid running under Rosetta translation unnecessarily.
FAQ
Do I need Docker Desktop to use kubectl on Mac?
No, kubectl only needs a valid kubeconfig pointing to any reachable cluster, local or remote.
How do I update kubectl once installed via Homebrew?
Simply run brew upgrade kubectl whenever a new version is released.
Conclusion
Whether you use Homebrew, MacPorts, or a manual curl download, getting kubectl running on macOS takes just a couple of minutes. Once installed, you’re ready to connect to any Kubernetes cluster and start deploying workloads.