Installing Kamiwaza | Kamiwaza Docs

Documentation for Kamiwaza 0.12.0

This document covers the installation process for Kamiwaza 0.12.0, which is no longer actively maintained. For the current GA release, see 1.0.1.

Before You Begin

Please review the System Requirements before proceeding with installation. This document covers:

Installation Workflows

Linux

Ubuntu 24.04 (Noble)

Architecture Download
x86_64 kamiwaza_v0.9.3_noble_x86_64.deb
ARM64 kamiwaza_v0.9.3_noble_arm64.deb 
# Update package index

sudo apt-get update

# Download the package (x86_64 example, replace with ARM64 variant as needed)

curl -LO https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_noble_x86_64.deb

# Install

sudo dpkg -i kamiwaza_v0.9.3_noble_x86_64.deb

sudo apt-get install -f

Ubuntu 22.04 (Jammy)

Architecture Download
x86_64 kamiwaza_v0.9.3_jammy_x86_64.deb
ARM64 kamiwaza_v0.9.3_jammy_arm64.deb 
sudo apt-get update

curl -LO https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_jammy_x86_64.deb

sudo dpkg -i kamiwaza_v0.9.3_jammy_x86_64.deb

sudo apt-get install -f

NVIDIA DGX Spark

A dedicated package for DGX Spark with Grace Blackwell CPU, including CUDA-ARM dependencies. For two-node deployments, install Kamiwaza on the head node only — the worker node only requires Docker and SSH access.

Architecture Download
ARM64 kamiwaza_v0.9.5_noble_arm64_dgx.deb 
sudo apt-get update

curl -LO https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.5_noble_arm64_dgx.deb

sudo dpkg -i kamiwaza_v0.9.5_noble_arm64_dgx.deb

sudo apt-get install -f

For two-node DGX Spark deployments (tensor parallelism across a Spark pair), see the Two-Node Deployment Guide.

Post-Installation Steps

After installation, clean up and start Kamiwaza:

# Clean up containers from the installation process

kamiwaza stop

# (Optional) Edit environment configuration for your deployment

# e.g., two-node setup, external URLs, authentication

sudo vi /opt/kamiwaza/kamiwaza/env.sh

# Start Kamiwaza

kamiwaza start

Verify service starts (see Quickstart).

RHEL .rpm Package Installation (for RHEL 9)

For standard online installation (recommended), see the Red Hat Installation Guide for complete step-by-step instructions including Docker setup and system dependencies.

For air-gapped or offline RHEL environments, see the Red Hat Offline Installation Guide.

Quick install (for users who already have Docker and dependencies installed):

# Download the package

curl -LO https://packages.kamiwaza.ai/rpm/kamiwaza_v0.9.3_rhel9_x86_64.rpm

# Install the package

sudo -E KAMIWAZA_ACCEPT_LICENSE=yes dnf install ./kamiwaza_v0.9.3_rhel9_x86_64.rpm

# Alternatively, for Enterprise Mode, Install the package with Kamiwaza License Key

sudo -E KAMIWAZA_ACCEPT_LICENSE=yes -E KAMIWAZA_LICENSE_KEY="YOUR_LICENSE_KEY" dnf install ./kamiwaza_v0.9.3_rhel9_x86_64.rpm

Community Edition on macOS

Only Community Edition is supported on macOS.

  1. Follow the guide: macOS tarball installation
  2. Ensure Docker Desktop is installed and running
  3. Run install.sh --community
  4. Access via browser at https://localhost

Community Edition on Windows

Use the MSI installer for a streamlined WSL2-based setup. See the Windows Installation Guide for prerequisites, GPU support, and step-by-step instructions.

Steps:

  1. Download: KamiwazaInstaller-[version]-[arch].msi
  2. Install: Run the MSI (reboot when prompted)
  3. Launch: Start Menu → "Kamiwaza Start"

Enterprise Edition Deployment

A. Terraform Deployment (Recommended)

Key Points:

B. Manual Cluster Deployment

Key Points:

Updating Kamiwaza

Windows

Linux/macOS

Uninstallation

Windows

Linux/macOS