Skip to main content
Version: 1.0.0

Installing Kamiwaza

Before You Begin​

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

  • Supported operating systems and versions
  • Hardware requirements (CPU, RAM, storage)
  • Required system packages and dependencies
  • Network and storage configuration
  • GPU support requirements

Installation Workflows​

Linux​

Ubuntu​

Ubuntu 24.04 (Noble)​
ArchitectureDownload
x86_64kamiwaza_v0.9.3_noble_x86_64.deb
ARM64kamiwaza_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)​
ArchitectureDownload
x86_64kamiwaza_v0.9.3_jammy_x86_64.deb
ARM64kamiwaza_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.

ArchitectureDownload
ARM64kamiwaza_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.

Red Hat Enterprise Linux 9​

Choose the workflow that matches your RHEL 9 environment:

Online workflow (recommended)

Use the Red Hat Installation Guide for internet-connected systems. It covers Docker setup, system dependencies, package installation, and post-install configuration.

If you require an air-gapped or otherwise offline installation, use the Red Hat Offline Installation Guide instead.

Offline workflow

Use the Red Hat Offline Installation Guide for restricted or air-gapped RHEL 9 environments that need staged artifacts and offline preparation.

Quick online 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

After Linux Installation​

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)

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​

Key Points:

  • Terraform handles complete cluster setup
  • cloud-init automatically runs first-boot.sh
  • Service starts automatically via systemd

B. Manual Cluster Deployment​

Key Points:

  • Requires manual cluster setup via cluster-manual-prep.sh
  • Must specify correct role (--head or --worker --head-ip=<IP>)
  • Service starts automatically via systemd

Updating Kamiwaza​

Windows​

  • Download new MSI installer and run to update existing installation
  • Restart if prompted for GPU changes

Linux/macOS​

  • Download new package
  • Run installation script again
  • Service will restart automatically

Uninstallation​

Windows​

  • Windows Settings → Add or Remove Programs -> (three dots on side) Uninstall

Linux/macOS​

  • Remove package via package manager
  • Clean up any remaining configuration files