Getting Started

Install Kunobi and connect to your first cluster. Follow the installation guide for your operating system below.

Installation

Release Channels

Kunobi publishes to two channels in parallel:

• Stable — Fully tested releases. Recommended for most users.
• Unstable — RC, beta, and alpha builds for early adopters who want to try features before they ship to stable.

Both channels share the same product identifier and the same in-app auto-update settings — installing one replaces the other. You can switch channels after install in Settings → Update Channel (see Release Channels).

The commands below cover the first install / opt-in to a channel; switching channels after install happens in the app.

Package Managers

The fastest way to install Kunobi is via a package manager. The Downloads page always shows the commands for your platform.

Homebrew (macOS)

Stable:

brew install --cask kunobi-ninja/kunobi/kunobi

Unstable:

brew install --cask kunobi-ninja/kunobi/kunobi-unstable

The unstable build ships from a separate kunobi-unstable cask in the kunobi-ninja/homebrew-kunobi tap.

apt (Linux)

Stable:

curl -fsSL https://r2.kunobi.ninja/apt/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/kunobi.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/kunobi.gpg] https://r2.kunobi.ninja/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/kunobi.list
sudo apt update
sudo apt install kunobi

Unstable:

curl -fsSL https://r2.kunobi.ninja/apt/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/kunobi.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/kunobi.gpg] https://r2.kunobi.ninja/apt unstable main" \
  | sudo tee /etc/apt/sources.list.d/kunobi.list
sudo apt update
sudo apt install kunobi-unstable

The unstable distribution also receives stable releases (since they're newer than pre-releases); unstable releases stay in unstable only.

winget (Windows)

Stable:

winget install kunobi-ninja.kunobi

Unstable:

winget install kunobi-ninja.kunobi.Unstable

Each channel has its own manifest in microsoft/winget-pkgs.

Chocolatey (Windows)

Stable:

choco install kunobi

Unstable:

choco install kunobi --pre

Chocolatey recognizes -rc, -beta, and -alpha suffixes as pre-releases; the --pre flag opts into them on the same package id.

aqua (cross-platform)

aqua init
aqua g -i kunobi-ninja/kunobi
aqua i

aqua resolves versions from GitHub tags directly. To use an unstable build, pin a pre-release tag (e.g. 1.2.3-rc1) in your aqua.yaml.

mise (cross-platform)

mise use aqua:kunobi-ninja/kunobi

Like aqua, mise resolves from GitHub tags. Pin a pre-release tag for unstable builds (e.g. mise use aqua:kunobi-ninja/kunobi@1.2.3-rc1).

Direct Download

Open the Downloads page, or click Downloads in the top navigation bar, to download the installer for your platform directly. Use the Stable / Unstable toggle at the top of the page to choose your channel before downloading.

macOS

1. Download the .dmg file
2. Open it and drag Kunobi to your Applications folder
3. Launch Kunobi from Applications

Windows

1. Download the installer
2. Run it and follow the installation wizard
3. Launch Kunobi from Start Menu or Desktop shortcut

Linux

1. Choose the package format that fits your distribution
2. For .deb:

   sudo dpkg -i Kunobi_*.deb
   sudo apt-get install -f  # fix dependencies if needed

3. For .AppImage, mark it executable and run it
4. For .rpm, install with your system package manager

Next Steps

Once Kunobi is installed, head to the Clusters page to connect your first cluster, or spin up a Demo Cluster to explore the interface.