Install on Docker for Mac

This guide walks you through the installation of the latest version of Knative Serving using pre-built images and demonstrates creating and deploying an image of a sample “hello world” app onto the newly created Knative cluster.

You can find guides for other platforms here.

Before you begin

Knative requires a Kubernetes cluster v1.11 or newer. If you don’t have one, you can create one using Docker for Mac. If you haven’t already, install Docker for Mac before continuing.

Creating a Kubernetes cluster

  1. After Docker for Mac is installed, configure it with sufficient resources. You can do that via the Advanced menu in Docker for Mac’s preferences. Set CPUs to at least 4 and Memory to at least 8.0 GiB.
  2. Now enable Docker for Mac’s Kubernetes capabilities and wait for the cluster to start up.

Installing Istio

Knative depends on Istio. Run the following to install Istio. (This changes LoadBalancer to NodePort for the istio-ingress service).

curl -L https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml \
  | sed 's/LoadBalancer/NodePort/' \
  | kubectl apply --filename -

# Label the default namespace with istio-injection=enabled.
kubectl label namespace default istio-injection=enabled

Monitor the Istio components until all of the components show a STATUS of Running or Completed:

kubectl get pods --namespace istio-system

It will take a few minutes for all the components to be up and running; you can rerun the command to see the current status.

Note: Instead of rerunning the command, you can add --watch to the above command to view the component’s status updates in real time. Use CTRL+C to exit watch mode.

Installing Knative Serving

Next, install Knative Serving.

Because you have limited resources available, use the https://github.com/knative/serving/releases/download/v0.2.2/release-lite.yaml file, which omits some of the monitoring components to reduce the memory used by the Knative components. To use the provided release-lite.yaml release, run:

curl -L https://github.com/knative/serving/releases/download/v0.2.2/release-lite.yaml \
  | kubectl apply --filename -

Note: Unlike minikube, we’re not changing the LoadBalancer to a NodePort here. Docker for Mac will assign localhost as the host for that LoadBalancer, making the applications available easily.

Monitor the Knative components until all of the components show a STATUS of Running:

kubectl get pods --namespace knative-serving

Just as with the Istio components, it will take a few seconds for the Knative components to be up and running; you can rerun the command to see the current status.

Note: Instead of rerunning the command, you can add --watch to the above command to view the component’s status updates in real time. Use CTRL+C to exit watch mode.

Now you can deploy an app to your newly created Knative cluster.

Deploying an app

Now that your cluster has Knative installed, you’re ready to deploy an app.

If you’d like to follow a step-by-step guide for deploying your first app on Knative, check out the Getting Started with Knative App Deployment guide.

If you’d like to view the available sample apps and deploy one of your choosing, head to the sample apps repo.

Note: You can replace the {IP_ADDRESS} placeholder used in the samples with localhost as mentioned above.

Cleaning up

Docker for Mac supports several levels of resetting its state and thus cleaning up.

To reset only the Kubernetes cluster to a fresh one, click “Reset Kubernetes cluster” in the Reset preferences.


Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.

Last modified 01.01.0001