Pre-Installation FAQ
Questions frequently asked from those who are curious about Bazzite.
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 which will be chosen based on hardware, desktop environment, and to include Steam Gaming Mode if the hardware supports it.
Bazzite offers multiple images, but most images will be following one of these two formats:
- Bazzite that automatically boots into Steam Gaming Mode with manual updates
- Bazzite that does not have Steam Gaming Mode and receives automatic updates daily
Images are split up between two types of Bazzite editions:
1. Desktop Edition
Steam Gaming Mode is not on these specific images!
Intended specifically for desktops and laptops with a focus on gaming which is influenced by SteamOS’s Desktop Mode and the maintenance-free nature of ChromeOS.
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.
2. Handheld/HTPC Edition (-deck Images)
Mimics SteamOS with “Steam Gaming Mode” and its features fully functional. This version of Bazzite boots directly into the Steam Gaming Mode session and are intended for handheld PCs and home theater setups.
Images 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 applied on a restart.
Steam Gaming Mode requires a modern AMD graphics card or an Intel Arc graphics card.
Desktop Environments & Specific Hardware Variants
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 Image Chart
| Image | Desktop Environment | Steam Gaming Mode | Hardware | Edition |
|---|---|---|---|---|
bazzite |
KDE Plasma | No | AMD/Intel GPUs | Desktop |
bazzite-nvidia |
KDE Plasma | No | Nvidia GPUs | Desktop |
bazzite-gnome |
GNOME | No | AMD/Intel GPUs | Desktop |
bazzite-gnome-nvidia |
GNOME | No | Nvidia GPUs | Desktop |
bazzite-deck: |
KDE Plasma | Yes | AMD/Intel Arc GPUs | Handheld/HTPC |
bazzite-deck-gnome |
GNOME | Yes | AMD/Intel Arc GPUs | Handheld/HTPC |
bazzite-asus |
KDE Plasma | No | ASUS Laptops (AMD/Intel GPUs | Desktop |
bazzite-asus-gnome |
GNOME | No | ASUS Laptops (AMD/Intel GPUs) | Desktop |
bazzite-asus-nvidia |
KDE Plasma | No | ASUS Laptops (Nvidia GPUs) | Desktop |
bazzite-gnome-asus-nvidia |
GNOME | No | ASUS Laptops (Nvidia GPUs) | Desktop |
bazzite-ally |
KDE Plasma | Yes | ASUS Laptops (Steam Gaming Mode Enabled) | Handheld/HTPC |
bazzite-ally-gnome |
GNOME | Yes | ASUS Laptops (Steam Gaming Mode Enabled) | Handheld/HTPC |
Who are the 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?
Since Bazzite is a custom Fedora Atomic Desktop image, it makes use of read-only root files for stability purposes, and is 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 the Universal Blue homepage for more information on what this project is capable of.
How is Fedora Atomic Desktop different than Fedora Workstation?
If you’re familiar with Fedora Workstation and Fedora’s Spins, but not the Fedora Atomic Desktops paradigm, the major difference is with stability between system upgrades. There are read-only root files and an emphasis on installing applications as a Flatpak or inside 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. There is also a future planned ahead of this technology. Upcoming additions like bootc will be a major change when it is ready for production.
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 utilities that Bazzite ships?
(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.
- Tool used for custom OCI Distrobox/Toolbox containers.
- 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.
- Discord chat overlay integration for Steam Gaming Mode.
- Handheld Daemon
- Tool for configuring handheld devices.
- Manages gyro, LEDs, paddles, and TDP.
- Tool for configuring handheld devices.
- 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 (Steam Deck hardware only): The Steam Deck does not come with secure boot enabled and does not ship with any keys enrolled by default, so do not enable this on Steam Deck hardware 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 Secure Boot guide.
Are AMD, Intel, and Nvidia graphics card drivers pre-installed?
Yes and they are updated during a system upgrade when avaliable
What if I change hardware?
Most hardware changes should not require any manual intervention outside of the expectations from that particular hardware which would be OS-agnostic.
However, if you swap from or to a Nvidia GPU, then rebasing will be necessary as a manual intervention to get the appropriate graphics drivers.
What is the difference between Bluefin, Aurora, and Bazzite?
Bluefin and Aurora are nearly identical outside of branding and desktop environment, but Bazzite strays away from both. All three are similar for desktop PCs and function similarly and share contributors between projects. Bluefin and Aurora target two audiences—individuals who want a maintenance-free Linux desktop experience and developers (using the -dx images).
Bazzite exclusively focuses on having an out of the box Linux gaming experience for desktop, HTPC hardware, and handhelds. Bazzite can be summed up as Bluefin and Aurora but tuned for PC gaming. A community-centric custom Fedora Atomic Desktop that is configured out of the box for their specific target audience, and in this case: PC gamers who want to use the Linux desktop as the alternative to Windows.
Post-Installation FAQ
Frequently asked questions by Bazzite users who have already installed Bazzite.
How do I change the hostname of my device?
Edit the /etc/hostname file with a new hostname, save it, and reboot.
hostnamectl hostname <hostname>
How do I switch to X11 on KDE Plasma Desktop images?
Note:
-nvidiaimages already include X11, but not for long.
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.
Why are 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 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