CLI Installation

The KTube CLI is the recommended way to install KTube. It is a single binary with no external dependencies.

Included: The CLI binary embeds a Kubernetes client, Helm SDK, and Kind - no external tools required.

Install the CLI

curl (Recommended)

$ curl -sSL https://ktube.dev/install.sh | bash

This script detects your OS/arch, downloads the binary, and installs to /usr/local/bin.

Homebrew (macOS/Linux)

$ brew tap ktube-dev/tap

$ brew install ktube

Go Install

$ go install github.com/ktube-dev/ktube/cmd/ktube@latest

Verify Installation

$ ktube version

ktube version 0.2.0
  commit: abc1234
  built:  2026-01-10T10:00:00Z
  go:     go1.24.0

Install KTube to Your Cluster

Step 1: Connect to Cluster

Ensure your kubeconfig is set up:

$ kubectl cluster-info

Or let KTube create a local cluster:

$ ktube cluster create

Step 2: Run Install

$ ktube install

Checking prerequisites...
✓ Connected to cluster (Kubernetes v1.29.0)

Installing KTube...
✓ Namespace created: ktube-system
✓ CRDs installed
✓ Operator deployed
✓ Dashboard deployed
✓ All pods ready

✓ KTube installed successfully!

Next steps:
  • Run 'ktube dashboard' to open the web UI
  • Run 'ktube status' to check installation

Installation Options

Flag	Description
--namespace	Install to custom namespace
--set key=value	Override Helm values
-f values.yaml	Use custom values file
--version	Install specific version

Uninstall

$ ktube uninstall

Next Steps

Configure a Provider - Set up Cloudflare, ngrok, or Dev Tunnels
CLI Reference - Explore all commands