Install with CLI

You can install Kubeshark using two main methods:

  1. CLI
  2. Helm

The quickest way to get started would be to download the Kubeshark CLI latest release, running kubeshark tap and pointing your browser to localhost:8899.

Kubeshark UI

Based on your use-case, see below additional installation methods like Helm, Homebrew and more:

Shell Script

You can use a shell script to download the right binary for your operating system and CPU architecture:

sh <(curl -Ls

Alternatively, you can download the right binary directly from the latest release.


Install using Homebrew:

brew tap kubeshark/kubeshark
brew install kubeshark

While this option is there, due to demand we invest more in the shell script and the Helm options. For this reason, we do not recommend using Homebrew.

Build from the Source

You can clone the Kubeshark GitHub repository and follow the instructions in the README file to build the CLI from the source:

git clone kubeshark/kubeshark
cd kubeshark & make

Tap (Run)

To run the CLI, use the tap command. For example:

kubeshark tap


When Kubeshark starts, to expose the dashboard port, it automatically starts a kube-proxy. If kube-proxy creation fails, it defaults to port-forward. Both kube-proxy and port-forward solutions can break after some time. You can always use:

kubeshark proxy

To re-establish a kube-proxy (or port-forward).

You can also, safely exit (use ^C) Kubeshark. It will continue to run in the background. Here again, you can use the kubehsark proxy command to re-establish a kube-proxy (or port-forward).


To clean all relics of Kubeshark from your cluster when using the CLI:

kubeshark clean

Exiting Kubeshark using ^C only breaks the kube-proxy / port-forward connection and does not remove Kubeshark from the cluster. Only clean command does.