Open-source project
ublue-os/bazzite avatar
ublue-os/bazzite

Bazzite: A Fedora Atomic Linux Image for Gaming PCs and Handhelds

Bazzite makes gaming and everyday use smoother and simpler across desktop PCs, handhelds, tablets, and home theater PCs.

9,132 stars1,117 forksJustApache-2.0

At a glance

What is it?
Bazzite is a custom Fedora Atomic image built for gaming on desktop PCs, handhelds, and home theater PCs. It ships with HDR, VRR, Steam Deck compatibility, and a catalog of pre-installed gaming tools, but it inherits the constraints of an immutable OS.
Who is it for?
Bazzite is a sensible choice for anyone who wants a gaming-first Linux install without spending time assembling drivers, tweaks, and utilities manually. The bazzite-deck variant is specifically built as a SteamOS alternative for the Steam Deck and other handhelds, booting directly to Game mode.
Can I use it commercially?
Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Just, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 1, 2026, and from our analysis. They are not legal advice.

Editorial analysis

What Bazzite Is and Who It Targets

Bazzite is a custom image built on Fedora Atomic, the immutable desktop variant of Fedora Linux. It targets three audiences: desktop PC users who want a gaming-ready Linux installation, handheld device users (Steam Deck and alternative handhelds such as the ROG Ally), and home theater PC users who want a console-like experience.

The project exists because stock Fedora does not ship with the drivers, kernel patches, and gaming utilities that most PC gamers need. Bazzite assembles those components into a single image: the OGC kernel for gaming-specific patches, HDR and VRR enabled by default, hardware-accelerated H.264 decoding, Xbox controller support via the xone driver, and DisplayLink support. Tools like vkBasalt, MangoHud, and OBS VkCapture are installed and available from the start.

Bazzite is not an original Linux distribution. It is built from ublue-os/main using Fedora technology, meaning it inherits Fedora's hardware support and security updates while adding gaming-specific configuration on top. The immutable base means the OS image itself is read-only; software additions happen through Flatpaks, the Distrobox container layer, or layered packages.

The Fedora Atomic Foundation and What Bazzite Layers On Top

Fedora Atomic desktops (Kinoite and Silverblue) use an image-based approach where the operating system is deployed as a container image rather than a set of individual packages. Updates are atomic: the system applies a new image and rolls back to the previous one if something breaks. Bazzite builds on this with the Universal Blue tooling from ublue-os/main.

On top of the Fedora Atomic base, Bazzite adds: the OGC kernel; HDR and VRR enabled by default; full hardware-accelerated codec support for H.264 decoding; xone for Xbox controllers; DisplayLink support; vkBasalt, MangoHud, and OBS VkCapture pre-installed; Distrobox for running other Linux distributions as containers; and the bees service for reducing Wine prefix disk use. ROM Properties Page is included for game file metadata, and HDMI CEC support is built in.

The Bazzite Portal application provides a graphical interface for installing additional tools: LACT for GPU tuning, OpenRazer drivers via a button or ujust install-openrazer in a terminal, and OpenTabletDriver via the portal or ujust install-opentabletdriver. Waydroid for running Android applications is pre-installed and documented in a setup guide at docs.bazzite.gg.

Installing Bazzite: ISO, Rebase, and Secure Boot

The primary install path for new machines is downloading an ISO from download.bazzite.gg and writing it to a USB drive. A detailed guide is available at docs.bazzite.gg/General/Installation_Guide/.

For users running an existing Fedora Atomic desktop who want to switch to Bazzite without reinstalling, the README provides rebase commands. For open-source GPU drivers:

bash
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite:stable

For machines with Nvidia GPUs that need proprietary drivers:

bash
rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/bazzite-nvidia:stable

The README notes that Mesa's open-source Nvidia option, NVK, was still prone to errors at the time of writing. For NVK issues the correct place to report is Mesa's bug tracker, not the Bazzite project.

For systems with Secure Boot enabled, the README directs users to follow the secure boot documentation before rebasing. The repository includes a secure_boot.der certificate file. Bazzite follows the Fedora Atomic model for Secure Boot enrollment.

The Steam Deck Variant and Handheld Mode

Bazzite ships a dedicated variant called bazzite-deck, designed as an alternative to SteamOS on the Steam Deck and as a console-like experience on HTPCs. This variant boots directly to Steam Game mode, matching SteamOS's default behavior.

Two performance properties are noted for the deck variant: the bees service substantially reduces the size of compatdata directories, which accumulate as Steam builds compatibility layers for Windows games. The latest version of Mesa in this variant creates smaller shader caches and does not require pre-built shader caches to prevent stutter.

Input Remapper is pre-installed but disabled by default on the deck variant, a deliberate choice to avoid conflicts with the game mode input stack. It can be enabled with ujust restore-input-remapper in a terminal.

For alternative handhelds beyond the Steam Deck, the README lists a separate section on supported devices, acknowledging that the handheld ecosystem extends beyond the original device Valve ships.

Software Management on an Immutable Base

Because the OS image is read-only, installing software on Bazzite works differently from a traditional package-managed Linux distribution. The primary paths are Flatpak (for graphical applications), Distrobox (for running containerized instances of other distributions with their native package managers), and rpm-ostree layer (for packages that need direct system access).

The README lists Flatseal, Warehouse, and Gear Lever as tools for managing Flatpak applications. Bazzite Portal provides a curated list of installs and tweaks, including buttons for system update, rebase, and reset to defaults.

Automatic updates for the OS image, Flatpaks, and other components are handled by uupd and topgrade. This is one of the more meaningful differences from a traditional distribution: users do not need to manage update scheduling manually.

Webapp Manager is available for creating browser-based application shortcuts, and Waydroid provides Android application support after going through a setup process documented at docs.bazzite.gg.

Limitations Compared to SteamOS and Traditional Linux Installs

Bazzite's immutable base is its largest constraint. Applications that expect to modify system files, install kernel modules outside the image's built-in set, or use package managers directly are either not supported or require a workaround through Distrobox. Engineers accustomed to apt, dnf, or pacman as their primary workflow will find the mental model different.

SteamOS, Valve's own gaming Linux distribution, is the natural comparison for the deck variant. Both projects use an immutable image approach and target the same gaming use case. SteamOS is maintained by Valve and ships on Steam Deck hardware. Bazzite uses a Fedora Atomic base and extends to desktop PCs and other handhelds. The README describes bazzite-deck as specifically positioned as an alternative to SteamOS, not a replacement for all Valve software.

For GNOME users, Bazzite offers a GNOME variant. The README documents GNOME-specific additions but does not list them in the truncated section. The primary desktop experience in the most common variants is KDE Plasma (Kinoite base).

The project does not ship official packages for non-x86 architectures. Users who want to build custom Bazzite images can use the Containerfile and Justfile in the repository.

Release Cadence, License, and Community

Bazzite tracks Fedora releases. The latest stable release at the time of writing is 44.20260928, released on 2026-09-28, which indicates Bazzite ships updates aligned with Fedora's release calendar. Testing releases appear in the repository before stable ones. The last push to the repository was on 2026-09-17.

The repository is licensed under Apache-2.0. This is an open license that permits commercial use, modification, and distribution, with patent and trademark clauses included. Bazzite is built using Universal Blue's tooling, which is itself open-source.

The project accepts community contributions. The repository includes GitHub Actions workflows for building both the OS image and the ISO. Users who want to build a customized image based on Bazzite can start from the Containerfile. The README lists a dedicated section on building your own image and signing it with cosign, including a cosign.pub key file in the repository for signature verification.

Editorial conclusion

Bazzite is a sensible choice for anyone who wants a gaming-first Linux install without spending time assembling drivers, tweaks, and utilities manually. The bazzite-deck variant is specifically built as a SteamOS alternative for the Steam Deck and other handhelds, booting directly to Game mode. Desktop users who want more traditional package management, or who rely on software that works poorly in Flatpak or Distrobox, should evaluate whether the Fedora Atomic base fits their workflow before installing. For Nvidia users, read the note in the README about NVK stability before choosing between open-source and proprietary driver variants.

Frequently asked questions

Is Bazzite as good as SteamOS?

The README describes bazzite-deck as designed as an alternative to SteamOS on the Steam Deck. Both use immutable image approaches and boot to Steam Game mode. Bazzite is based on Fedora Atomic and extends to desktop PCs and alternative handhelds, while SteamOS is Valve's distribution and ships on Steam Deck hardware by default.

What is Bazzite used for?

Bazzite is used for gaming on desktop PCs, handheld computers like the Steam Deck and ROG Ally, and home theater PCs. It ships with HDR, VRR, Xbox controller drivers, and gaming tools like MangoHud and vkBasalt pre-installed on a Fedora Atomic base.

What are the downsides of Bazzite?

The immutable OS base means software installation works differently from traditional Linux: most applications go through Flatpak or Distrobox rather than a conventional package manager. The README also notes that Mesa's open-source Nvidia option (NVK) was prone to errors at time of writing, and directs affected users to Mesa's bug tracker rather than the Bazzite project.

How do I install Bazzite?

Download an ISO from download.bazzite.gg and follow the installation guide at docs.bazzite.gg/General/Installation_Guide/. Existing Fedora Atomic users can rebase to Bazzite using rpm-ostree rebase with the ghcr.io/ublue-os/bazzite:stable image, or the bazzite-nvidia variant for proprietary Nvidia drivers.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/ublue-os-bazzite.svg)](https://hysenlabs.com/projects/ublue-os-bazzite)