Skip to main content
Version: 0.9.3

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

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​

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