# Documentation for Kamiwaza 0.11.0

This version is no longer actively maintained. For the current GA release, see [**1.0.1**](https://docs.kamiwaza.ai/).

## Before You Begin

**Please review the [System Requirements](https://docs.kamiwaza.ai/0.11.0/installation/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 Version         | Architecture | Download                                                                                 |
|------------------------|--------------|-----------------------------------------------------------------------------------------|
| 24.04 (Noble)         | x86_64      | [kamiwaza_v0.9.3_noble_x86_64.deb](https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_noble_x86_64.deb) |
| 24.04 (Noble)         | ARM64       | [kamiwaza_v0.9.3_noble_arm64.deb](https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_noble_arm64.deb) |
| 24.04 (Noble)         | ARM64 (DGX Spark) | [kamiwaza_v0.9.3_noble_arm64_dgx.deb](https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_noble_arm64_dgx.deb) |
| 22.04 (Jammy)         | x86_64      | [kamiwaza_v0.9.3_jammy_x86_64.deb](https://packages.kamiwaza.ai/deb/kamiwaza_v0.9.3_jammy_x86_64.deb) |
| 22.04 (Jammy)         | ARM64       | [kamiwaza_v0.9.3_jammy_arm64.deb](https://packages.kamiwaza.ai/deb/kamiwaza_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:

```bash
# 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](https://docs.kamiwaza.ai/0.11.0/installation/redhat_online_install) 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](https://docs.kamiwaza.ai/0.11.0/installation/redhat_offline_install) instead.

**Offline workflow**

Use the [Red Hat Offline Installation Guide](https://docs.kamiwaza.ai/0.11.0/installation/redhat_offline_install) 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:

```bash
# 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](https://docs.kamiwaza.ai/0.11.0/quickstart))

### Community Edition on macOS

_Only Community Edition is supported on macOS._

1. Follow the guide: [macOS tarball installation](https://docs.kamiwaza.ai/0.11.0/installation/macos_tarball)
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](https://docs.kamiwaza.ai/0.11.0/installation/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