Getting Started

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

Installation

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)

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

apt (Linux)

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

winget (Windows)

winget install kunobi-ninja.kunobi

aqua (cross-platform)

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

Coming soon: Chocolatey and mise support are on the roadmap.

Direct Download

Open the Downloads page, or click Downloads in the top navigation bar, to download the installer for your platform directly.

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.