Skip to content

Installation

Bazzite AI OS can be installed by rebasing from a Bazzite KDE installation or running as a virtual machine.

KDE Only

Bazzite AI requires a Bazzite KDE variant as the base. GNOME variants are not supported.

Rebase from Bazzite KDE

If you have a Bazzite KDE 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, verify your installation and set up development tools:

Step Command Description Recording
1 ujust install devtools Install development tools
2 ujust config dev-environment verify Verify tools installed

GPU Setup

Step Command Description Recording
1 ujust config gpu setup Setup GPU container support
2 ujust config gpu status Verify GPU configuration

NVIDIA Users

NVIDIA RTX 20+ series GPUs work automatically after running ujust config gpu setup. AMD and Intel GPUs work immediately via /dev/dri passthrough with no configuration required.

What gets configured:

  • Container toolkit: nvidia-container-toolkit + CDI config
  • Device passthrough for containers
  • GPU detection for pods

Run Development Pods

After GPU setup, run containers with GPU access:

Command Description Recording
ujust apptainer pull Pull ML container image
ujust apptainer shell Run interactive shell
ujust apptainer gpu Check GPU detection

For detailed GPU compatibility and troubleshooting, see GPU Setup.

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 Setup for details.

See Also