Usage of Astronomer Enterprise Edition (EE) requires a subscription.

Install Kubernetes Locally via Docker For Mac Edge

This guide details the steps to get Kubernetes installed locally on a machine running OSx. At the time of writing Docker Kube is only available on Docker For Mac Edge meaning that some features may not behave as fully intended.


Kubernetes For Mac Install

This section will walk you through the installation of Kubernetes on Docker. It is recommended that you use Kubernetes on Docker and not minikube as several users have failed to get working installs via the minikube method.

Installation Steps

  1. Download Docker For Mac Edge
  2. Enable Kubernetes Support on Docker Edge


  1. Verify install by running the kubectl command in terminal

Note: Docker for Mac Edge stability

Warning: Docker for Mac Edge is somewhat unstable

While Kubernetes for Docker for Mac is in beta, you may see Kubernetes stop working after an upgrade, need to reset the Kubernetes cluster, reset Docker itself to factory defaults, or a full uninstall and reinstall.

Given this, we recommend not installing new releases right away if you are doing production work. A more stable approach is to watch the issues related to Kubernetes in the the days following a new release.

Homebrew Install

Homebrew is a package manager that describes itself as installing `the stuff you need that Apple didn’t.’

Installation Steps

  1. Install Homebrew


  1. Verify install by running the homebrew command in terminal

Helm via Homebrew Install

Helm is a package manager for Kubernetes itself. In Helm a package is called a Chart. Under the hood a Chart is a collection of files definiting the configuration of Kubernetes resources. The Kubernetes github organization provides a list of stable Charts.

Installation Steps

There are a couple of helm installation options, for this install we will be using homebrew.

  1. run brew install kubernetes-helm
  2. run helm init
    • This command will deploy the helm server to your Docker Kubernetes cluster


  1. verify install by running the helm version command in terminal

Kubernetes WebUI Dashboard Install

The Kubernetes dashboard is the command central of your Kubernetes cluster. From here you can graphically monitor the status of deployments as well as dive into the logs to troubleshoot failed deployments. We will be using the install from the Kubernetes Githup.

Installation Steps

  1. kubectl apply -f
    • This will pulldown and apply the official Kubernetes dashboard.
  2. kubectl proxy
    • This will expose the dashboard to your localhost


  1. Verify successful deployment of dashboard by navigating to dashboard homepage found at