Skip to content

Installation

Bazzite AI OS can be installed via ISO, rebasing from Bazzite, or running as a QEMU virtual machine.

Fresh Installation (ISO)

Download the latest ISO from GitHub Releases and create a bootable USB drive.

Create Bootable USB

Use one of these tools:

  • Fedora Media Writer (recommended)
  • balenaEtcher
  • Ventoy (multi-boot USB)

Install

  1. Boot from the USB drive
  2. Follow the Anaconda installer prompts
  3. Select KDE Plasma desktop (GNOME is not supported)
  4. Complete installation and reboot

Rebase from Existing Bazzite

If you already have Bazzite or another Fedora Atomic variant installed, you can rebase directly:

# Rebase to Bazzite AI stable
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/atrawog/bazzite-ai:stable

# Reboot to apply
systemctl reboot

Available Image Tags

Tag Description
stable Latest stable release (recommended)
latest Most recent build from main branch
43 Fedora 43 base (current)

Post-Installation

After first boot:

# Show available commands
ujust --list

# Setup GPU pod access (NVIDIA users)
ujust setup-gpu-pods

# Pull and run a development pod with Apptainer
apptainer pull docker://ghcr.io/atrawog/bazzite-ai-pod-nvidia-python:stable
apptainer shell --nv bazzite-ai-pod-nvidia-python_stable.sif

Troubleshooting

Boot Issues

If the system doesn't boot after rebase:

  1. At GRUB menu, select the previous deployment
  2. Once booted, rollback: rpm-ostree rollback
  3. Report the issue on GitHub Issues

GPU Not Detected

For NVIDIA GPUs, ensure you're using an RTX 20-series or newer. See GPU Compatibility for details.

See Also