Skip to content

Installation

kubara is distributed via Homebrew and as prebuilt release archives. You do not need Go installed to run the CLI.

Installation Methods

Install

brew tap kubara-io/tap
brew install kubara
kubara --help

Update

brew upgrade kubara

Uninstall

brew uninstall kubara

Install

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.kubara.io/apt-public.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubara.gpg
echo "deb [signed-by=/etc/apt/keyrings/kubara.gpg] https://apt.kubara.io stable main" | sudo tee /etc/apt/sources.list.d/kubara.list > /dev/null
sudo apt update
sudo apt install -y kubara

Uninstall

sudo apt remove -y kubara
sudo rm -f /etc/apt/sources.list.d/kubara.list /etc/apt/keyrings/kubara.gpg
sudo apt update

For commands that need cluster access (e.g. bootstrap), mount your kubeconfig:

docker run --rm \
  -u $(id -u):$(id -g) \
  -v ~/.kube/config:/kubeconfig:ro \
  -v $(pwd):/workspace \
  -w /workspace \
  ghcr.io/kubara-io/kubara <your-command>

For local-only commands (e.g. init, generate, schema), kubeconfig is not required:

docker run --rm \
  -u $(id -u):$(id -g) \
  -v $(pwd):/workspace \
  -w /workspace \
  ghcr.io/kubara-io/kubara <your-command>
curl -sSLf https://raw.githubusercontent.com/kubara-io/kubara/refs/heads/main/install.sh | sh
kubara --help

The script downloads the latest release for your platform and verifies checksums automatically.

Download the matching release archive from:

https://github.com/kubara-io/kubara/releases

Current release artifacts: - Linux: kubara_<version>_linux_amd64.tar.gz, kubara_<version>_linux_arm64.tar.gz - macOS: kubara_<version>_darwin_amd64.tar.gz, kubara_<version>_darwin_arm64.tar.gz

tar -xzf kubara_<version>_<os>_<arch>.tar.gz
chmod +x kubara
sudo mv kubara /usr/local/bin/kubara
kubara --help

Download the matching Windows .zip release asset from:

https://github.com/kubara-io/kubara/releases

Current release artifacts: - kubara_<version>_windows_amd64.zip - kubara_<version>_windows_arm64.zip

Open a terminal (PowerShell) in the extracted folder and run:

.\kubara.exe --help

Optional: move kubara.exe to a directory in your PATH.

Verify Checksums

Each release includes a checksum file. Run these checksum commands in your terminal on Linux/macOS:

sha256sum kubara_<version>_<os>_<arch>.<ext>

On macOS you can also use:

shasum -a 256 kubara_<version>_<os>_<arch>.<ext>