Skip to main content

Installation Guide

TunaOS images can be installed in several ways, depending on your needs and preferences.

System Requirements​

ComponentMinimumRecommended
CPUx86_64, ARM64x86_64, ARM64
RAM4 GB8 GB+
Storage20 GB50 GB+

Architecture Support​

  • x86_64: Standard 64-bit Intel/AMD processors
  • x86_64_v2: Optimized for older CPUs (pre-2013) - available for Albacore and Yellowfin
  • ARM64: 64-bit ARM processors (Apple Silicon, Raspberry Pi 4+, etc.)

Installation Methods​

Method 1: Download Pre-built ISOs​

The easiest way to get started is downloading pre-built ISO images:

Albacore (AlmaLinux 10)​

Yellowfin (AlmaLinux Kitten 10)​

Method 2: Build Your Own ISO​

Use the TunaOS build script to create custom ISOs:

# Download the build script
curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
-o build-bootc.sh
chmod +x build-bootc.sh

# Build an ISO for your preferred variant
sudo ./build-bootc.sh iso ghcr.io/tuna-os/yellowfin:latest

# Or build a VM image
sudo ./build-bootc.sh qcow2 ghcr.io/tuna-os/yellowfin:latest

Method 3: Container Runtime​

For testing or container-based workflows:

# Pull your preferred variant
podman pull ghcr.io/tuna-os/albacore:latest
podman pull ghcr.io/tuna-os/yellowfin:latest
podman pull ghcr.io/tuna-os/bonito:latest
podman pull ghcr.io/tuna-os/skipjack:latest

Post-Installation​

After installation, TunaOS provides:

Pre-installed Applications​

  • GNOME 48.3: Latest GNOME desktop environment
  • Homebrew: Package manager for CLI tools and fonts
  • Flathub: Full access to Flatpak applications

Getting Started​

  1. Complete the initial setup wizard
  2. Install additional software via Flathub (Software app)
  3. Use Homebrew for command-line tools: brew install <package>
  4. Check out the Project Bluefin documentation for general usage

Variant-Specific Features​

DX (Developer Experience)​

  • libvirt virtualization
  • Docker containers
  • VSCode IDE
  • Development toolchains

GDX (Graphical Developer Experience)​

  • NVIDIA drivers and CUDA
  • AI/ML development tools
  • Graphics and video editing software

Troubleshooting​

Boot Issues​

  • Ensure Secure Boot is disabled or properly configured
  • Check system requirements are met
  • Try the x86_64_v2 variant for older hardware

Installation Problems​

  • Verify ISO integrity after download
  • Use a different USB creation tool (Ventoy, Rufus, dd)
  • Check available disk space

Getting Help​