Install the kftray desktop app or kftui terminal interface on macOS, Linux, or Windows.

Install

There are several ways to install kftray. Pick the method that matches your platform and preference, then move on to the Quick Start.

Desktop Interface (kftray)

Install via Homebrew (recommended):

brew tap hcavarsan/kftray
brew install --cask kftray

Or download kftray_universal.dmg from the latest release. The universal binary works on both Intel and Apple Silicon.

Install via Homebrew:

brew tap hcavarsan/kftray
brew install kftray-linux

Or download the AppImage from the latest release:

kftray_amd64.AppImage — x86_64 systems
kftray_aarch64.AppImage — ARM64 systems

Make it executable before running:

chmod +x kftray_amd64.AppImage
./kftray_amd64.AppImage

GNOME Users

The system tray icon requires AppIndicator support. Install the AppIndicator extension for the tray icon to appear. KDE, XFCE, and i3 include tray support by default.

Download the installer from the latest release:

kftray_x64-setup.exe — standard x86_64 systems
kftray_arm64-setup.exe — ARM64 devices (Surface Pro X, etc.)

The installer configures PATH and creates Start Menu entries automatically.

Terminal Interface (kftui)

brew tap hcavarsan/kftray
brew install kftui

cargo install kftui

Requires a working Rust toolchain. See rustup.rs if you don't have one.

bash <(curl -s https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.sh)

Or with wget:

bash <(wget -qO- https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.sh)

This installs kftui to /usr/local/bin/ and requires sudo for the system-wide install.

Run in PowerShell:

Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.ps1'))

Manual Binary Downloads

If the installer scripts don't work in your environment (corporate firewalls, restricted networks), download binaries directly from the latest release:

Platform	Desktop	Terminal
macOS (Universal)	`kftray_universal.dmg`	`kftui_macos_universal`
Linux x86_64	`kftray_amd64.AppImage`	`kftui_amd64`
Linux ARM64	`kftray_aarch64.AppImage`	`kftui_arm64`
Windows x64	`kftray_x64-setup.exe`	`kftui_x86_64.exe`
Windows ARM64	`kftray_arm64-setup.exe`	—

Verifying the Installation

Launch kftray from your applications menu. You should see a system tray icon (a small Kubernetes logo). Click it to open the main configuration interface.

kftui

You should see a text-based interface with an empty configuration list and keyboard shortcuts at the bottom. Press Ctrl+C to exit.

Configuration Storage

Both interfaces store data in ~/.kftray/:

File	Purpose
`kftray.db`	SQLite database with all configurations and state
`app.log`	Application logs
`http_logs/`	HTTP traffic captures (when enabled)

This directory is shared between both interfaces, so configurations created in one appear instantly in the other.

Install

Install the kftray desktop app or kftui terminal interface on macOS, Linux, or Windows.

Install

There are several ways to install kftray. Pick the method that matches your platform and preference, then move on to the Quick Start.

Desktop Interface (kftray)

Install via Homebrew (recommended):

brew tap hcavarsan/kftray
brew install --cask kftray

Or download kftray_universal.dmg from the latest release. The universal binary works on both Intel and Apple Silicon.

Install via Homebrew:

brew tap hcavarsan/kftray
brew install kftray-linux

Or download the AppImage from the latest release:

kftray_amd64.AppImage — x86_64 systems
kftray_aarch64.AppImage — ARM64 systems

Make it executable before running:

chmod +x kftray_amd64.AppImage
./kftray_amd64.AppImage

GNOME Users

The system tray icon requires AppIndicator support. Install the AppIndicator extension for the tray icon to appear. KDE, XFCE, and i3 include tray support by default.

Download the installer from the latest release:

kftray_x64-setup.exe — standard x86_64 systems
kftray_arm64-setup.exe — ARM64 devices (Surface Pro X, etc.)

The installer configures PATH and creates Start Menu entries automatically.

Terminal Interface (kftui)

brew tap hcavarsan/kftray
brew install kftui

cargo install kftui

Requires a working Rust toolchain. See rustup.rs if you don't have one.

bash <(curl -s https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.sh)

Or with wget:

bash <(wget -qO- https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.sh)

This installs kftui to /usr/local/bin/ and requires sudo for the system-wide install.

Run in PowerShell:

Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.ps1'))

Manual Binary Downloads

If the installer scripts don't work in your environment (corporate firewalls, restricted networks), download binaries directly from the latest release:

Platform	Desktop	Terminal
macOS (Universal)	`kftray_universal.dmg`	`kftui_macos_universal`
Linux x86_64	`kftray_amd64.AppImage`	`kftui_amd64`
Linux ARM64	`kftray_aarch64.AppImage`	`kftui_arm64`
Windows x64	`kftray_x64-setup.exe`	`kftui_x86_64.exe`
Windows ARM64	`kftray_arm64-setup.exe`	—

Verifying the Installation

Launch kftray from your applications menu. You should see a system tray icon (a small Kubernetes logo). Click it to open the main configuration interface.

kftui

You should see a text-based interface with an empty configuration list and keyboard shortcuts at the bottom. Press Ctrl+C to exit.

Configuration Storage

Both interfaces store data in ~/.kftray/:

File	Purpose
`kftray.db`	SQLite database with all configurations and state
`app.log`	Application logs
`http_logs/`	HTTP traffic captures (when enabled)

This directory is shared between both interfaces, so configurations created in one appear instantly in the other.