Using Bazzite

Bazzite is a Fedora Atomic (immutable) Linux distribution optimized for gaming, with special editions for Steam Deck, handheld PCs, and HTPCs. This skill navigates the complete Bazzite documentation to answer usage and configuration questions.

Key commands: ujust (system tasks) | rpm-ostree (system packages) | flatpak (apps) | distrobox (containers)

Update: System updates automatically; manual: ujust update

How to Use This Skill

1. •Identify user intent from the topic index below
2. •Read the relevant doc file(s) from the docs/src/ subdirectory (paths are relative to this skill's directory)
3. •Answer using the documentation content

Always read docs before answering - don't rely on general knowledge about Bazzite.

Bazzite Image Variants

Users must choose the correct image. Key decision points:

Check current image: rpm-ostree status

For detailed image selection, read docs/src/General/FAQ.md (see "What Bazzite image do I use?")

Topic Index

Getting Started

Installation Guides

Installing Software

Updates, Rollbacks & Rebasing

Gaming

Handheld & HTPC Edition (Steam Gaming Mode)

Troubleshooting & Configuration

Advanced Topics

Keyword Quick Reference

Common search terms -> doc file (all paths under docs/src/):

Installation & Setup

• •install, setup, ISO -> General/Installation_Guide/ (by device type)
• •dual boot, windows -> General/Installation_Guide/dual_boot_setup_guide.md
• •secure boot, mokutil -> General/Installation_Guide/secure_boot.md
• •partition, btrfs -> General/Installation_Guide/manual_partitioning.md
• •which image, -deck, -gnome -> General/FAQ.md

Software Management

• •ujust, just, bazzite portal -> Installing_and_Managing_Software/ujust.md
• •flatpak, flathub -> Installing_and_Managing_Software/Flatpak.md
• •brew, homebrew -> Installing_and_Managing_Software/Homebrew.md
• •container, distrobox, podman -> Installing_and_Managing_Software/Distrobox.md
• •android, waydroid -> Installing_and_Managing_Software/Waydroid_Setup_Guide.md
• •layer, rpm-ostree -> Installing_and_Managing_Software/rpm-ostree.md

Updates & System

• •update, upgrade -> Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/updating_guide.md
• •rollback, downgrade, revert -> Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rolling_back_system_updates.md
• •rebase, switch image -> Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rebase_guide.md
• •immutable, atomic, ostree -> General/terms.md + General/Fedora_Atomic_Comparison.md

Gaming

• •steam, proton, wine, launch options -> Gaming/Game_Launchers.md
• •lutris, heroic, gog, epic -> Gaming/Game_Launchers.md
• •nvidia, amd, gpu, driver -> Gaming/Hardware_compatibility_for_gaming.md
• •controller, gamepad, joystick -> Gaming/Hardware_compatibility_for_gaming.md + General/issues_and_resolutions.md
• •mod, nexus, vortex, mo2 -> Gaming/Managing_and_modding_games.md
• •dlss, fsr, upscaling -> Gaming/Game_Launchers.md

Handheld/HTPC

• •deck, gaming mode, gamescope -> Handheld_and_HTPC_edition/Steam_Gaming_Mode.md
• •legion go, rog ally -> Device-specific in Handheld_and_HTPC_edition/Handheld_Wiki/
• •decky, css loader -> General/Desktop_Environment_Tweaks.md
• •big picture, couch -> Handheld_and_HTPC_edition/Steam_Gaming_Mode.md

Troubleshooting

• •wifi, ethernet, network -> General/issues_and_resolutions.md
• •audio, sound, volume -> General/issues_and_resolutions.md
• •auto login -> General/issues_and_resolutions.md
• •fast startup (Windows) -> General/issues_and_resolutions.md
• •kde, gnome, theme -> General/Desktop_Environment_Tweaks.md

Software Installation Priority

Bazzite recommends software installation methods in this order:

1. •ujust - System tasks and curated software (ujust --choose)
2. •Flatpak - Sandboxed desktop apps (Flathub)
3. •Homebrew - CLI tools and development packages
4. •Quadlet - Containerized services (Podman)
5. •Distrobox - Full Linux environments in containers
6. •AppImage - Portable standalone apps
7. •rpm-ostree - Layer system packages (discouraged, use sparingly)

Key Commands Reference

# System updates
ujust update              # Update everything
ujust bios                # Check BIOS updates (Framework, handhelds)

# Software discovery
ujust                     # List all available commands
ujust --choose            # Interactive menu of available tasks
ujust | grep "keyword"    # Search for specific commands

# View ujust script source
ujust --show <command>    # See what a command does before running

# Rollback
ujust rollback            # Rollback helper
rpm-ostree rollback       # Manual rollback to previous deployment

# Rebase (switch images)
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite:stable

# System info
rpm-ostree status         # Show current and previous deployments

ujust Command Prefixes