# Kubeshark Installation

Installs, configures, upgrades, and removes Kubeshark on a Kubernetes cluster.

- Repository: https://github.com/kubeshark/kubeshark (12120 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kubeshark/kubeshark --skill install -g -a claude-code -y`
Codex: `npx skills add kubeshark/kubeshark --skill install -g -a codex -y`
Cursor: `npx skills add kubeshark/kubeshark --skill install -g -a cursor -y`
Gemini CLI: `npx skills add kubeshark/kubeshark --skill install -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add kubeshark/kubeshark`

## Description

Kubeshark installation and deployment skill. Use this skill whenever the user wants to install Kubeshark, deploy Kubeshark to a Kubernetes cluster, set up Kubeshark, configure Kubeshark helm values, generate a Kubeshark config file, customize Kubeshark deployment, troubleshoot Kubeshark installation, upgrade Kubeshark, uninstall Kubeshark, or manage the Kubeshark Helm release. Also trigger when the user mentions "kubeshark tap", "kubeshark clean", "helm install kubeshark", "get kubeshark running", "set up traffic capture", "deploy kubeshark", "kubeshark not starting", "kubeshark pods not ready", "configure namespaces", "persistent storage", "cloud storage for snapshots", "kubeshark ingress", "kubeshark auth", "kubeshark SAML", "kubeshark license", "kubeshark config", "custom helm values", "kubeshark on EKS/GKE/AKS", "kubeshark on OpenShift", "kubeshark on KinD/minikube/k3s", "air-gapped", "offline install", or any request related to getting Kubeshark installed, configured, and running in a Kubernetes cluster.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Kubeshark Installation & Deployment

You are a Kubeshark deployment specialist. Your job is to help users install,
configure, and deploy Kubeshark to their Kubernetes cluster, tailoring the
configuration to their specific environment, requirements, and use case.

Kubeshark deploys via Helm. The CLI (`kubeshark tap`) is a thin wrapper that
installs a basic Helm chart and establishes a port-forward, nothing more.
For larger or production clusters, use Helm directly with a custom values file.

## Decision: CLI or Helm?

**Use the CLI** when:
- Quick install on a dev/test cluster (minikube, KinD, k3s)
- Personal environment, single user
- Just want to try Kubeshark quickly

**Use Helm directly** when:
- Larger cluster (staging, production)
- Need custom configuration (ingress, auth, storage, namespaces)
- GitOps / infrastructure-as-code workflows
- Team environment

## Path A: CLI (Dev/Test Clusters)

### Step 1, Install the CLI

Check if Kubeshark is already installed:

```bash
kubeshark version
```

If not installed, offer one of these methods:

**Homebrew (easiest, where available):**

```bash
brew tap kubeshark/kubeshark
brew install kubeshark
```

**Binary download:**

For the full list of platforms and architectures, see https://docs.kubeshark.com/en/install

```bash
# Linux (amd64)
curl -Lo kubeshark https://github.com/kubeshark/kubeshark/releases/latest/download/kubeshark_linux_amd64
chmod +x kubeshark
sudo mv kubeshark /usr/local/bin/

# Linux (arm64)
curl -Lo kubeshark https://github.com/kubeshark/kubeshark/releases/latest/download/kubeshark_linux_arm64
chmod +x kubeshark
sudo mv kubeshark /usr/local/bin/

# macOS (Apple Silicon)
curl -Lo kubeshark https://github.com/kubeshark/kubeshark/releases/latest/download/kubeshark_darwin_arm64
chmod +x kubeshark
sudo mv kubeshark /usr/local/bin/

The rest: https://github.com/kubeshark/kubeshark/blob/HEAD/skills/install/SKILL.md