Documentation for Kamiwaza 0.11.0

This version 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:

• 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 .deb Package Installation

Download the appropriate package for your Ubuntu version and architecture:

ARM64 Package Selection:

• ARM64 - For generic ARM64 systems (AWS Graviton, Ampere Altra, etc.)
• ARM64 (DGX Spark) - For NVIDIA DGX Spark with Grace Blackwell CPU (includes CUDA-ARM dependencies)

Install using dpkg:

# Download the package (example for Ubuntu 24.04 x86_64)

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

# Install the package

sudo dpkg -i kamiwaza_v0.9.3_noble_x86_64.deb

# Install any missing dependencies

sudo apt-get install -f

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

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

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