LevitateOS

Documentation

Getting Started

Download a LevitateOS variant and create bootable installation media (desktop variants).

Section

Requirements

  • CPU: x86_64, Intel Haswell (2013) or AMD Zen (2017) or newer
  • RAM: 16GB minimum, 32GB+ recommended for local LLM inference
  • Storage: 512GB NVMe SSD minimum (1TB+ recommended for AI models)
  • GPU: NVIDIA RTX 3060+ (12GB VRAM) for LLM acceleration, or CPU-only with 32GB+ RAM
  • Boot: UEFI required (Secure Boot must be disabled)

WARNING

Default update model: A/B immutable (slot updates + rollback). Mutable mode is an explicit opt-in for daredevils, and is unsafe if you let an LLM author recipes without review. See Atomic Updates (A/B).

Section

Download

Download the variant you want from Download. Desktop variants ship as live ISOs; appliance variants ship as disk images.

Example: download the LevitateOS ISO and verify the checksum:

Command
bash 
curl -LO https://releases.levitateos.org/latest/LevitateOS.iso
curl -LO https://releases.levitateos.org/latest/SHA256SUMS
sha256sum -c SHA256SUMS

Section

Creating Bootable Media

USB Drive (Linux/macOS)

Command
bash 
# Find your USB device (usually /dev/sdX or /dev/diskX)
lsblk  # Linux
diskutil list  # macOS

# Write the ISO (CAUTION: this erases the drive)
sudo dd if=LevitateOS.iso of=/dev/sdX bs=4M status=progress oflag=sync

USB Drive (Windows)

Use Rufus with DD image mode.

Virtual Machine (QEMU)

Command
bash 
# Create a 256GB virtual disk
qemu-img create -f qcow2 disk.qcow2 256G

# Boot the installer
qemu-system-x86_64 \
  -m 8G \
  -smp 4 \
  -enable-kvm \
  -cpu host \
  -bios /usr/share/ovmf/OVMF.fd \
  -cdrom LevitateOS.iso \
  -drive file=disk.qcow2,format=qcow2,if=virtio \
  -boot d

Section

Next Steps

Boot from the ISO to enter the live environment, then follow the Installation Guide to install LevitateOS.