Installing Kamiwaza | Kamiwaza Docs

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)

deploy with terraform

cloud-init

first-boot.sh

Service Running

Key Points:

B. Manual Cluster Deployment

deploy image

cluster-manual-prep.sh --head/--worker

first-boot.sh

Service Running

Key Points:

Updating Kamiwaza

Windows

Linux/macOS

Uninstallation

Windows

Linux/macOS