Documentation for Kamiwaza 0.9.3

This documentation covers the installation process for Kamiwaza 0.9.3, which is no longer actively maintained.

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 24.04 (Noble)

# 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)

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.

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)

Download and install the RPM package:

# Download the package

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

# Install the package

sudo dnf install ./kamiwaza_v0.9.3_rhel9_x86_64.rpm

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

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:

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

B. Manual Cluster Deployment

deploy image

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

first-boot.sh

Service Running

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