Installation

KubeGraf is distributed as a single binary with no dependencies. Choose your preferred installation method below.

Prerequisites: You need a working kubectl configuration with access to a Kubernetes cluster.

Quick Install

The fastest way to install KubeGraf on macOS or Linux:

curl -sSL https://kubegraf.io/install.sh | bash

This script automatically detects your OS and architecture, downloads the appropriate binary, and installs it to /usr/local/bin.

macOS

Homebrew Recommended

brew install kubegraf/tap/kubegraf

To upgrade: brew upgrade kubegraf

Manual (Apple Silicon)

curl -LO https://github.com/kubegraf/kubegraf/releases/latest/download/kubegraf-darwin-arm64.tar.gz
tar xzf kubegraf-darwin-arm64.tar.gz
sudo mv kubegraf /usr/local/bin/

Manual (Intel)

curl -LO https://github.com/kubegraf/kubegraf/releases/latest/download/kubegraf-darwin-amd64.tar.gz
tar xzf kubegraf-darwin-amd64.tar.gz
sudo mv kubegraf /usr/local/bin/

Linux

x86_64 / AMD64

curl -LO https://github.com/kubegraf/kubegraf/releases/latest/download/kubegraf-linux-amd64.tar.gz
tar xzf kubegraf-linux-amd64.tar.gz
sudo mv kubegraf /usr/local/bin/

ARM64

curl -LO https://github.com/kubegraf/kubegraf/releases/latest/download/kubegraf-linux-arm64.tar.gz
tar xzf kubegraf-linux-arm64.tar.gz
sudo mv kubegraf /usr/local/bin/

Windows

Scoop Recommended

scoop bucket add kubegraf https://github.com/kubegraf/scoop-bucket
scoop install kubegraf

Manual (PowerShell)

Invoke-WebRequest -Uri "https://github.com/kubegraf/kubegraf/releases/latest/download/kubegraf-windows-amd64.zip" -OutFile kubegraf.zip
Expand-Archive kubegraf.zip -DestinationPath $env:USERPROFILE\bin
# Add $env:USERPROFILE\bin to your PATH

Verify Installation

After installation, verify KubeGraf is working:

kubegraf --version

You should see output like:

kubegraf version 1.0.0 (go1.21.0)

Next Steps

Now that KubeGraf is installed, check out the Quick Start Guide to connect to your first cluster.