Windows Installation Guide | Kamiwaza Docs

System Requirements

Minimum Requirements

Operating System: Windows 11
Memory: 8GB RAM minimum (16GB+ recommended)
GPU: NVIDIA modern GPUs and Intel Arc Supported (requires drivers)
Storage: 20GB free disk space
Architecture: x64 (64-bit) processor
Administrator Access: The installer will request permission when needed

Recommended for Optimal Performance

Memory: 32GB+ RAM for large workloads
GPU: NVIDIA GeForce RTX series or Intel Arc GPU (for hardware acceleration)
Storage: SSD with 50GB+ free space

Prerequisites Setup

Step 1: Enable WSL (Windows Subsystem for Linux)

If WSL is not already installed on your system:

Open PowerShell as Administrator
- Right-click Start button → "Windows PowerShell (Admin)"
Install WSL
```
wsl --install
```
Restart your computer when prompted
Verify WSL installation
```
wsl --version
```

Step 2: Verify GPU Access (If Applicable)

Note: GPU verification will be performed automatically during installation. The installer will detect and configure GPU access for supported hardware.

Supported GPUs:

NVIDIA GeForce RTX series (30, 40 and 50 series)
Intel Arc GPUs Note: Kamiwaza currently supports only NVIDIA GPUs and Intel Arc GPUs for hardware acceleration. For Intel Arc GPU setup instructions, please refer to the separate Intel Arc WSL GPU virtualization documentation.

Step 3: Install Windows Terminal (Optional but Recommended)

Download from Microsoft Store or GitHub releases

Download and Installation

Step 1: Download Kamiwaza Installer

Contact your Kamiwaza representative to obtain the installer download link or file:

File: https://packages.kamiwaza.ai/win/kamiwaza_installer_0.5.1_x86_64.msi
Size: Approximately 30-40MB

Step 2: Run the Installer

Locate the downloaded MSI file in your Downloads folder
Double-click to run the installer
When prompted by Windows User Account Control, click "Yes" to allow the installer to make changes to your device
Follow the installation wizard

Configuration Options:

Email Address: Your registered email address
License Key: Provided by Kamiwaza support
Installation Mode:
- Lite - Basic installation (recommended for most users)
- Full - Complete installation with all features
Dedicated Memory: Select RAM allocation for Kamiwaza
- Recommended: 50%-75% of total system RAM
- Example: 16GB system → Select 12GB allocation

Step 3: Installation Process

The installer will automatically:

Download and install Ubuntu 24.04 WSL distribution (if not present)
Reserve network ports (61100-61299)
Detect GPU hardware (NVIDIA RTX, Intel Arc only)
Configure WSL environment with optimized settings
Install Kamiwaza platform in dedicated WSL instance
Setup GPU acceleration (if compatible hardware detected)

Expected Installation Time:

Standard Installation: 15-30 minutes
First-time WSL Setup: Add 10-15 minutes
Large Package Downloads: May take longer on slower connections

Step 4: GPU Driver Restart

If GPU acceleration was configured, you'll be prompted to restart your device. It is recommended to restart immediately to ensure proper GPU driver initialization.

Access Your Installation

Option 1: System Tray Access (Primary Method)

After installation, Kamiwaza will automatically launch and appear in your system tray. Right-click the Kamiwaza system tray icon to access the following options:

Show Kamiwaza Manager - Open the main management interface
Kamiwaza Status - Check current platform status
Start Kamiwaza - Start the platform if stopped
Stop Kamiwaza - Stop the running platform
Open Kamiwaza - Launch the web interface
Exit - Close the system tray application

Option 2: WSL Command Line Access

Access the Kamiwaza WSL environment and start the platform:

wsl -d kamiwaza

kamiwaza start

Option 3: Start Menu Shortcuts

After installation, find these shortcuts in Start Menu → "Kamiwaza":

Install Kamiwaza - Initial setup and installation
Start Platform - Launch Kamiwaza platform
Cleanup WSL - Complete removal tool

Option 4: Direct Browser Access

Once running, access Kamiwaza at:

URL: https://localhost

Platform Management

Primary Method: System Tray

The easiest way to manage Kamiwaza is through the system tray icon. Right-click the Kamiwaza icon in your system tray to access all management options.

Alternative Method: Command Line

From PowerShell or Command Prompt:

# Start Kamiwaza

wsl -d kamiwaza -- kamiwaza start

# Stop Kamiwaza

wsl -d kamiwaza -- kamiwaza stop

# Restart Kamiwaza

wsl -d kamiwaza -- kamiwaza restart

# Check status

wsl -d kamiwaza -- kamiwaza status

Troubleshooting

Common Issues

Installation Fails with "WSL not found"

Ensure WSL is installed: wsl --install
Restart computer after WSL installation
Verify with: wsl --version

Ubuntu-24.04 Distribution Not Found

The installer will automatically download and install Ubuntu 24.04 if needed
If installation fails, check existing distributions: wsl --list --verbose
Re-run the installer if necessary

Memory Allocation Errors

Reduce memory allocation in installer
Ensure sufficient free RAM on system
Close other memory-intensive applications

GPU Detection Issues

Ensure latest GPU drivers are installed
Check Windows version supports GPU passthrough
Confirm GPU compatibility (NVIDIA or Intel Arc only)

Network Access Problems

Check Windows Firewall settings
Verify ports 61100-61299 are available
Try accessing https://localhost instead of http://

Getting Help

Check Installation Logs

WSL logs:

wsl -d kamiwaza -- journalctl -t kamiwaza-install

Windows logs:

Check Event Viewer → Applications

Installation and other logs should also be located on your Windows device at: C:\Users\[USER]\AppData\Local\Kamiwaza\logs

GPU Status Check

wsl -d kamiwaza -- /usr/local/bin/kamiwaza_gpu_status.sh

Support Contact

Technical Support: Contact our support team
License Issues: Contact our support team

Uninstallation

To completely remove Kamiwaza:

Option 1: Use Windows Settings

Settings → Apps → Find "Kamiwaza Installer" → Uninstall

Option 2: Use Start Menu shortcut

Start Menu → Kamiwaza → "Cleanup WSL (Uninstall)"

Option 3: Manual cleanup if needed

wsl --unregister kamiwaza