🌅 OpenIndiana Up#

A simple, powerful CLI tool to spin up OpenIndiana virtual machines with QEMU

✨ Features#

• 🚀 Quick Start - Launch OpenIndiana VMs with a single command
• 📦 Auto-Download - Automatically downloads ISO images from official sources
• 🎯 Version Support - Specify exact OpenIndiana versions or use the latest default
• 💾 Persistent Storage - Attach virtual disk drives for data persistence
• ⚡ KVM Acceleration - Native hardware acceleration for better performance
• 🌐 SSH Ready - Pre-configured port forwarding (host:2222 → guest:22)
• 🎛️ Customizable - Configure CPU, memory, cores, and disk options
• 📥 Smart Caching - Skips re-downloading existing ISO files

📋 Requirements#

• Deno runtime
• QEMU with KVM support
• Linux host with KVM enabled

🛠️ Installation#

Run the following command to install the CLI:

deno install -A -g -r -f --config deno.json ./main.ts -n openindiana-up

🚀 Quick Start#

# Use default OpenIndiana version (20251026)
openindiana-up

# Specify a version
openindiana-up 20251026

# Use a local ISO file
openindiana-up /path/to/openindiana.iso

# Download from a custom URL
openindiana-up https://dlc.openindiana.org/isos/hipster/20251026/OI-hipster-text-20251026.iso

🎮 Usage#

openindiana-up [path-or-url-to-iso-or-version] [options]

Options#

💡 Examples#

Basic VM with defaults#

openindiana-up

VM with custom resources#

openindiana-up -C 4 -m 4G

VM with persistent storage#

# Create a disk image first
qemu-img create -f qcow2 openindiana-disk.qcow2 20G

# Launch with the disk attached
openindiana-up -d openindiana-disk.qcow2 --disk-format qcow2

Download to specific location#

openindiana-up -o ~/isos/openindiana.iso

🖥️ Console Setup#

When OpenIndiana boots, you'll see the boot menu. For the best experience with the serial console:

1. Select option 3. Escape to loader prompt
2. Configure console output:

   set console=ttya
   set osconsole=ttya
   set ttya-mode=115200,8,n,1,-
   boot
   

This enables proper console redirection to your terminal.

⚙️ VM Configuration#

The script creates a VM with the following default specifications:

• CPU: Host CPU with KVM acceleration (configurable with --cpu)
• Memory: 2GB RAM (configurable with --memory)
• Cores: 2 virtual CPUs (configurable with --cpus)
• Storage: ISO-only by default; optional persistent disk (configurable with --drive)
• Network: User mode networking with SSH forwarding
• Console: Enhanced serial console via stdio with proper signal handling
• Default Version: OpenIndiana 20251026 (when no arguments provided)

Available CPU Types#

Common CPU types you can specify with --cpu:

• host (default) - Use host CPU features for best performance
• qemu64 - Generic 64-bit CPU for maximum compatibility
• Broadwell - Intel Broadwell CPU
• Skylake-Client - Intel Skylake CPU
• max - Enable all supported CPU features

Available Disk Formats#

Common disk formats you can specify with --disk-format:

• raw (default) - Raw disk image format for maximum compatibility
• qcow2 - QEMU Copy On Write format with compression and snapshots
• vmdk - VMware disk format
• vdi - VirtualBox disk format

🔌 SSH Access#

The VM is configured with port forwarding for SSH access:

# After OpenIndiana is installed and SSH is configured
ssh -p 2222 user@localhost

📝 Notes#

• The script uses text-based installer ISOs for better headless compatibility
• Downloaded ISOs are cached and won't be re-downloaded if they exist
• KVM acceleration requires /dev/kvm access on your host system
• Serial console is connected to stdio for direct interaction

📜 License#

See LICENSE file for details.

🤝 Contributing#

Contributions, issues, and feature requests are welcome!

Made with ☀️ for OpenIndiana enthusiasts