Skip to main content
Version: 0.9.3 (Latest)

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

Download the appropriate package for your Ubuntu version and architecture:

Ubuntu VersionArchitectureDownload
24.04 (Noble)x86_64kamiwaza_v0.9.3_noble_x86_64.deb
24.04 (Noble)ARM64kamiwaza_v0.9.3_noble_arm64.deb
24.04 (Noble)ARM64 (DGX Spark)kamiwaza_v0.9.3_noble_arm64_dgx.deb
22.04 (Jammy)x86_64kamiwaza_v0.9.3_jammy_x86_64.deb
22.04 (Jammy)ARM64kamiwaza_v0.9.3_jammy_arm64.deb

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

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​

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