Bazzite Frequently Asked Questions (FAQ)

Why is it called Bazzite?

Fedora Linux’s Atomic Desktops originally followed a naming scheme based on minerals. Bazzite is a mineral that is known for being strong, lightweight, and is colored blue.

What Bazzite image do I use?

Bazzite’s website offers a streamlined way of selecting the correct image for you.

Image Variants

Bazzite offers multiple images, but most images will be following one of these two formats:
Desktop and Handheld/HTPC

Images are split up between two types of Bazzite editions:

1. Desktop Edition

Note: You can still use Steam Gaming Mode on supported desktop hardware, but then it would not be considered a Desktop image. Intended specifically for desktops and laptops with a focus on gaming which is influenced by SteamOS’s “Desktop Mode.”

Steam and other gaming utilities are part of the base operating system. System rollbacks available with a rock-solid stable Fedora Linux base. Updates are automatically downloaded in the background and applied on a restart. Most modern hardware should be compatible outside of specific drivers that do not work well on desktop Linux.

The choice of KDE Plasma and GNOME for the desktop environment with others planned for the future. Flathub is enabled out of the box, so all of the applications that you would find on SteamOS are available on Bazzite.

There is no Steam Gaming Mode on these specific images!

2. Handheld/HTPC Edition

Mimics SteamOS with “Steam Gaming Mode” and its features fully functional. This variant boots directly into the Steam Gaming Mode session and are intended for handheld PCs and home theater setups.

Also includes a Desktop Mode session with the choice of GNOME or KDE Plasma and is based on our Desktop images. Updates are manually installed by the user and can be applied in both sessions. Gaming Mode can be used on most devices using a modern AMD graphics card.

Intel ARC graphics cards also work as well (with some major caveats) but other Intel GPUs are unsupported!

All Nvidia graphics cards are currently not supported on these specific images.

Desktop Environments & Specific Hardware

Both types of images also come with the choice of using KDE Plasma or GNOME for the desktop environment and certain images are made with specific hardware support.

There is more information about this topic on the Installation Guide to help guide users on which image to choose before the installation.

Bazzite’s Target Audiences

  • Desktop users who want an operating system designed for gaming with inspiration from SteamOS that has fairly low maintenance.
  • Steam Deck users who feel limited by SteamOS and also want newer system packages.
  • Home Theater PC setups for a console-like experience.
  • Handheld PC users who would prefer a SteamOS-like experience.

SteamOS is based on Arch Linux, so why use Fedora Linux?

SteamOS receives package and driver updates less frequently despite the rolling release base.

Bazzite will follow Fedora’s update release cycle which means early access to new graphics card driver and kernel updates in comparison to SteamOS.

Fedora Linux and Universal Blue currently supports a specific “atomic” implementation to maintain multiple images that can receive all of the same updates at once, which is unlike a derivative Linux distribution.

The goal of Bazzite is to have an operating system ready to game after installing it.

Any advantages to using Fedora?

Bazzite makes use of read-only root files for stability purposes, but is Fedora Linux built with libostree which has advantages such as:

  • Low risk of an unbootable system
  • Rollback system updates if necessary, and the ability to pin your current deployment as a backup save state without losing user data.
  • Smooth upgrade process from major Fedora point releases.
  • Layer Fedora packages to the host that survive between updates.
  • Focus on containerized applications that do not interfere with your host system.

Check out Fedora Atomic Desktops and Universal Blue homepage for more information on what this project is capable of.

What is the difference with Fedora Atomic Desktops vs. Traditional Linux?

If you’re familiar with Fedora Workstation and Fedora’s Spins, but not the Fedora Atomic Desktops paradigm, then the major difference deals with stability between system upgrades. There are read-only root files and an emphasis on installing applications as a Flatpak or inside Distrobox containers. Read more about obtaining software on Bazzite.

Users can rollback to a previous deployment if a system update breaks their workflow, or rebase entirely back to a stock Fedora Atomic image, Aurora, Bluefin, or a custom image by the community. Do not rebase between different desktop environments. Read more about how updates, rolling back, and rebasing works on Bazzite.

Here’s a helpful cheat sheet for using advanced commands, but gives a glimpse of what this paradigm is capable of.

Is this another fringe Linux distribution?

Bazzite is not a Linux distribution in the traditional sense. It’s a custom Fedora Atomic Desktop image with a recipe on top of it. Universal Blue images are a proof of concept of using containerized workflows with transactional and in-place operating system updates, and Bazzite exists by being gaming focused with inspiration from SteamOS.

Essentially, Bazzite is a Fedora Atomic Desktop installation, but with the aid of Universal Blue’s tooling, adds packages, services, drivers, etc. to the base image of it.

How does Bazzite differ?

Bazzite is using a new “container-native” approach that Fedora has been testing, and we are taking full advantage of it.

We are utilizing the Open Container Initiative (OCI) to build the images, and are simply adding packages, services, kernel modules, and our own spin to existing Fedora operating systems.

The ultimate goal of Bazzite is to be Fedora Linux, but provide a great gaming experience out of the box while also being an alternative operating system for the Steam Deck.

Unlike traditional Linux distributions, most of the maintenance and security updates are done upstream by Fedora and Universal Blue while Bazzite only has to focus on creating a great experience for PC gaming.

Image Matrix

We provide several different images that all get the same additions and fixes through updates at the same time unless specified otherwise. Many images are hardware specific for compatibility reasons, yet all of the images will usually receive the same features and fixes at the same time.

There can be a hypothetical scenario where everyone involved with Bazzite could stop maintaining the project at once and it will still continue to receive updates directly from upstream.

Can this be used as a daily driver?

Yes.

Updates are obtained and downloaded straight from upstream which means there is little maintenance to be done with the image on our end since these images are modified Fedora images.

Users will receive application and system updates from Bazzite, Universal Blue, and Fedora daily.

A friendly reminder that this project is still in its early stages and moving at a fast pace with updates and changes nearly daily.

What are some of the unique applications that Bazzite uses?

(in alphabetical order)

  • Boxkit
    • Tool used for custom OCI Distrobox/Toolbox containers.
      • Anything from DaVinci Resolve to OBS Studio Portable can be accessed with this. These applications run in their own special container, so dependencies do not affect your host.
  • Discover Overlay
    • Discord chat overlay integration for Steam Gaming Mode.
      • It has a special configuration for Bazzite where it automatically starts when you are in Gaming Mode and Discord is running on Handheld/HTPC images.
  • Ptyxis
    • Terminal with first-class container support .
  • ujust
    • Execute custom commands based on recipes.
  • yafti (Bazzite Portal)
    • First-boot utility for installing additional software.

Is Secure Boot supported?

WARNING: The Steam Deck does not come with secure boot enabled and does not ship with any keys enrolled by default. Do not enable this unless you absolutely know what you’re doing!

Yes, but you will have to enroll our key.

More information on enrolling the key in our Installation Guide.

How do I switch to X11 on KDE Plasma images?

Note: -nvidia images already include X11.

Install the required X11 package in a host terminal with this command:

rpm-ostree install plasma-workspace-x11

Reboot and select X11 as your session in the login screen.

WARNING: When the Fedora 41 builds of Bazzite (v. 4.0.0+) are released then you must remove this package to update properly.

What if I change hardware?

Most hardware changes should not require any manual intervention outside of the expectations from that particular hardware. However, if you swap from or to a Nvidia GPU, then rebasing will be necessary as a manual intervention.

Why are builds failing?

Builds Failing

Do not be alarmed if you see this on our Github repository.

Builds can fail for a number of reasons, but it’s only temporary. You can still install and use Bazzite without any issues. Latest features and fixes may be delayed until the builds are successfully built again however.

How do I change the hostname of my device?

Edit the /etc/hostname file with a new hostname, save it, and reboot.

sudoedit /etc/hostname

How do I report a bug?

Update before reporting

First, see if the bug is already fixed in an update by manually updating the system, then rebooting to see if the issue still persists between updates.

Attaching system logs

Open a host terminal and enter:

ujust device-info

Attach the link that it outputs for system logs.

Experience a crash?

ujust logs-last-boot

Translations:

Documentation Contributors: Kyle Gospodnetich, RJ Trujillo, Nathaniel Warburton, and Jorge Castro

See also: Steam Gaming Mode Overview (Handheld/HTPC)

View all Bazzite documentation

2 Likes

With the new website, this link is dead, not sure if all that info is contained in other documentation pages here under discourse?

Thanks for catching that. The information on the introductory documentation was outdated anyways, so I removed the link from here.

Here’s the Introductory Documentation on the Wayback Machine archive if you are interested to see what it stated.

Thanks for the reply. I have found https://blue-build.org/ which seems to piece together some of the confusion over where the prior documentation went to and why it was split off to this separate project.

1 Like

How would one update from winetricks-20230212 to winetricks-20240105? How is it installed?

Use lutris for winetricks.