Kamiwaza 0.8.0 Installation Documentation

This is documentation for Kamiwaza 0.8.0, which is no longer actively maintained. For the current GA release, see 1.0.1.

Version: 0.8.0

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

1. Add Kamiwaza repository to APT sources

   echo "deb [signed-by=/usr/share/keyrings/kamiwaza-archive-keyring.gpg] https://packages.kamiwaza.ai/ubuntu/ noble main" | sudo tee /etc/apt/sources.list.d/kamiwaza.list
   

2. Import and install Kamiwaza GPG signing key

   curl -fsSL https://packages.kamiwaza.ai/gpg | sudo gpg --dearmor -o /usr/share/keyrings/kamiwaza-archive-keyring.gpg
   

3. Update package database and install Kamiwaza

   sudo apt update
   

sudo apt upgrade

sudo apt install kamiwaza

4. Verify service starts (see [Quickstart](https://docs.kamiwaza.ai/0.8.0/quickstart))

#### RHEL .rpm Package Installation (for RHEL 9)
- For offline/air-gapped RHEL installations, see the comprehensive [Red Hat Offline Installation Guide](https://docs.kamiwaza.ai/0.8.0/installation/redhat_offline_install).

#### Other Linux Distros via Tarball
1. Follow the consolidated guide: [Linux/macOS tarball installation](https://docs.kamiwaza.ai/0.8.0/installation/linux_macos_tarball)
2. Ensure Docker Engine (with Compose v2), Python 3.10, and Node.js 22 are available (installer may configure as needed)
3. Run `install.sh --community`
4. Access via browser at `https://localhost`

### Community Edition on macOS
_Only Community Edition is supported on macOS._

1. Follow the consolidated guide: [Linux/macOS tarball installation](https://docs.kamiwaza.ai/0.8.0/installation/linux_macos_tarball)
2. Ensure Docker Engine (with Compose v2), Python 3.10, and Node.js 22 are available (installer may configure as needed)
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.8.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