Installing kn

This guide provides details about how you can install the Knative kn CLI.

Installing the kn CLI

Using Homebrew

For macOS, you can install kn by using Homebrew.

  1. brew install knative/client/kn

Using a binary

You can install kn by downloading the executable binary for your system and placing it in the system path.

A link to the latest stable binary release is available on the kn release page.

Using Go

  1. Check out the kn client repository:

    1. git clone https://github.com/knative/client.git
    2. cd client/
  2. Build an executable binary:

    1. hack/build.sh -f
  3. Move kn into your system path, and verify that kn commands are working properly. For example:

    1. kn version

Using a container image

Links to images are available here:

You can run kn from a container image. For example:

  1. docker run --rm -v "$HOME/.kube/config:/root/.kube/config" gcr.io/knative-releases/knative.dev/client/cmd/kn:latest service list

Note

Running kn from a container image does not place the binary on a permanent path. This procedure must be repeated each time you want to use kn.

Having issues upgrading kn?

If you are having issues upgrading using Homebrew, it may be due to a change to a CLI repository, where master branch was renamed to main. If so, run

  1. brew tap --repair
  2. brew update
  3. brew upgrade kn

to resolve the issue.

Install kn using the nightly-built binary

Warning

Nightly container images include features which may not be included in the latest Knative release and are not considered to be stable.

Nightly-built executable binaries are available for users who want to install the latest pre-release build of kn.

Links to the latest nightly-built executable binaries are available here:

Using kn with Tekton

See the Tekton documentation.