kubescape/docs/installation.md

Installation Guide

This guide covers all the ways to install Kubescape on your system.

Table of Contents

• Quick Install
• Package Managers
• Manual Installation
• Verification
• Updating
• Uninstalling

---

Quick Install

Linux / macOS (Recommended)

curl -s https://raw.githubusercontent.com/kubescape/kubescape/master/install.sh | /bin/bash

This script:

• Detects your OS and architecture (x86_64, ARM64/M1/M2)
• Downloads the latest release
• Installs to ~/.kubescape/
• Adds to your PATH

Windows (PowerShell)

Requires PowerShell v5.0 or higher:

iwr -useb https://raw.githubusercontent.com/kubescape/kubescape/master/install.ps1 | iex

If you get an execution policy error:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Install a Specific Version

curl -s https://raw.githubusercontent.com/kubescape/kubescape/master/install.sh | /bin/bash -s -- -v v3.0.0

---

Package Managers

Homebrew (macOS/Linux)

brew install kubescape

Note

: The official Homebrew formula has git scanning disabled. For full functionality:

brew tap kubescape/tap
brew install kubescape-cli

Krew (kubectl plugin)

kubectl krew update
kubectl krew install kubescape

# Use as kubectl plugin
kubectl kubescape scan

Ubuntu / Debian

sudo add-apt-repository ppa:kubescape/kubescape
sudo apt update
sudo apt install kubescape

For other Debian-based or RPM-based distributions, see the OpenSUSE Build Service.

Arch Linux

# Build from source
yay -S kubescape

# Or install pre-built binary (faster)
yay -S kubescape-bin

Note

: AUR packages are community-supported.

openSUSE

sudo zypper refresh
sudo zypper install kubescape

Note

: Community-supported.

NixOS / Nix

# Try in ephemeral shell
nix-shell -p kubescape

# Or add to configuration.nix
environment.systemPackages = with pkgs; [ kubescape ];

# Or with home-manager
home.packages = with pkgs; [ kubescape ];

Note

: Community-supported. See NixOS support for issues.

Snap

sudo snap install kubescape

Chocolatey (Windows)

choco install kubescape

Note

: Community-supported.

Scoop (Windows)

scoop install kubescape

Note

: Community-supported.

---

Manual Installation

Download from GitHub Releases

1. Go to the Releases page
2. Download the appropriate binary for your OS/architecture
3. Make it executable and move to your PATH:

# Linux/macOS example
chmod +x kubescape
sudo mv kubescape /usr/local/bin/

Build from Source

git clone https://github.com/kubescape/kubescape.git
cd kubescape
make build

---

Verification

After installation, verify Kubescape is working:

# Check version
kubescape version

# Run a simple scan (requires cluster access)
kubescape scan

# Or scan a sample file
kubescape scan https://raw.githubusercontent.com/kubernetes/examples/master/guestbook/all-in-one/guestbook-all-in-one.yaml

Expected Output

Kubescape version: vX.X.X

---

Updating

Script Installation

Re-run the install script to get the latest version:

curl -s https://raw.githubusercontent.com/kubescape/kubescape/master/install.sh | /bin/bash

Package Managers

Use your package manager's update command:

# Homebrew
brew upgrade kubescape

# apt
sudo apt update && sudo apt upgrade kubescape

# Krew
kubectl krew upgrade kubescape

---

Uninstalling

Script Installation

rm -rf ~/.kubescape
# Remove from PATH in your shell config (.bashrc, .zshrc, etc.)

Package Managers

Use your package manager's uninstall command:

# Homebrew
brew uninstall kubescape

# apt
sudo apt remove kubescape

# Krew
kubectl krew uninstall kubescape

---

Next Steps

• Getting Started Guide - Run your first scan
• CLI Reference - Full command reference
• Troubleshooting - Common issues and solutions