Installing Bazzite and Initial Setup¶
ATTENTION:
We are migrating documentation to Discourse. The Installation Guide is updated over there and this page will soon be removed.
Warning
Fedora's installer has some issues with OCI images currently since this feature is still new. If you have any issues installing, please consult our FAQ page here.
Attention
Most of our ISOs require an internet connection! Make sure to connect to either a wired or wireless network inside the installer under the "Network" category to properly install it.
Attention
It is HIGHLY RECOMMENDED to install Bazzite with a user password that has administrative privileges so you can install certain software.
This is a visual guide for installing Bazzite.
Video Guides¶
Pre-Requisites¶
- Make sure you meet the system requirements for Fedora Linux.
- A graphics card that can utilize Vulkan 1.3 or later. Most modern AMD, Nvidia, and Intel GPUs should be fine.
- The drive that Bazzite is installed to must have at least 32GB unallocated drive space.
- A USB flash drive, external drive, or microSD card with at least 5GB of free space on it. (This will remove existing data on it!)
- A working and stable wired or wireless internet connection.
- Download the latest ISO release here.
- Software to flash the image to your flash drive, external drive, or microSD card. We recommend using Fedora Media Writer, Balena Etcher, or Rufus. Ventoy is unsupported.
- Bazzite requires a physical wired keyboard to install properly.
- See Fedora Kinoite documentation and Fedora Silverblue documentation for more information.
Boot into your installation medium.¶
Connect your bootable medium to your device and boot into it. This depends on your hardware, most of the time it's the function keys (ex: F9). It's very dependent on the motherboard in your device.
Sometimes you need to consult the manual or read any hotkeys when you boot your PC. You can alternatively change BIOS settings, which can also be any of the function keys, to boot with your flash drive first before your current storage, but this is not recommended to keep on after installing.
For the Steam Deck, hold the 'Volume Down' button and click the Power Button, and when you hear the chime, let go of the Volume Down button, and you'll be booted into the Boot Manager.
When you get to the boot menu, select your bootable device to boot into the Bazzite installer.
Bazzite Variants¶
When you boot into the installer, you will be presented a list of Bazzite images.
- Bazzite offers multiple images, but most images will be following one of these two formats: Desktop and Steam Deck/HTPC.
- Desktop images are for general desktop computing and attempt to mimic SteamOS's Desktop Mode in terms of functionality.
- Steam Deck/HTPC images boot directly into Game Mode and are intended for handheld PCs and home theater PCs.
- These images also come with the choice of KDE Plasma or GNOME for their desktop environments.
Common images:¶
-
bazzite is the AMD/Intel GPU general desktop image intended for most personal computers.
-
bazzite-nvidia is bazzite but for PCs running Nvidia GPUs as they include their proprietary drivers in the image.
-
bazzite-deck is a special Steam Deck/HTPC/Handheld PC image of Bazzite. More details on that here.
-
bazzite-gnome is bazzite, but instead of using KDE Plasma as the desktop environment, it uses GNOME.
-
bazzite-gnome-nvidia is bazzite-gnome but for PCs running Nvidia GPUs as they include their proprietary drivers in the image.
-
bazzite-deck-gnome is bazzite-deck but instead of using KDE Plasma as the desktop environment, it uses GNOME.
There are also images specific to specialized hardware like bazzite-framework (Framework hardware), bazzite-surface (Microsoft Surface hardware), etc.
KDE Plasma and GNOME Desktop Environments Differences at a Glance¶
KDE Plasma¶
- KDE Plasma's default interface has a traditional and familiar layout.
- Highly customizable.
- Uses Qt for GUI.
- Fedora Kinoite & SteamOS use KDE Plasma.
GNOME¶
- GNOME's default interface has an elegant and touch-friendly layout.
- Workflow is designed to be out of the user's way.
- Uses GTK (GNOME Toolkit) for GUI.
- Fedora Silverblue & Ubuntu use GNOME.
Installing Bazzite¶
After selecting the image the installation setup screen should come up:
- Select your language, region, keyboard layout, and time zone.
- Select your network. (You need to be connected to internet for this to install properly!)
- Select/Add the drive you would like to install Bazzite to. (This will delete all of the data on the drive!)
- Make sure to only check the drive you plan to install Bazzite since all of your drives might be selected including microSD!
- Optionally encrypt the drive with a password if you wish. (If you lose this password, you will not be able to decrypt your drive!)
- Setup a user account and optionally a root account, and begin the installation.
Root account is mainly used on PCs with multiple users. You can give an administrator password to a single user account for root privileges.
Proceed with the installation. This may take a long time to install and the progress indicator may not be accurate.
First Boot Setup¶
After booting up for the first time after installation, a window will pop up saying "Welcome to Bazzite." This is a utility that allows you to tailor Bazzite to your liking by configuring it and pre-installing applications. It is necessary that you complete this step after installation.
Click "Next" to begin configuring Bazzite. Press the toggle switch button next to the item to have the option enabled or disabled for your installation, some are already toggled on by default. If you want to adjust and customize any of the options, press the arrow next to the toggle switch button if available.
Login to Steam (required for Steam Deck, HTPC, and Handheld PC images), and reboot your device when you finish.
If you have a microSD card and had game installed on SteamOS, and do NOT want to reinstall your video games, then select "Use EXT4 for SD cards" in the Bazzite Portal.
Note
For users with Secure Boot enabled:
Run ujust enroll-secure-boot-key
in the host terminal and enter the password ublue-os
if prompted to enroll the required key!
Game on!¶
You have installed Bazzite!
If you need any additional applications check out the software center that comes preinstalled. Look for the shopping bag icon called either Discover or GNOME Software depending on which variant of Bazzite you have installed. Check out the most popular software available to install.
Linux Gaming Guide¶
For a quick run-through of the basics of gaming on desktop Linux, take a look here.
Waydroid Setup¶
Check out the Waydroid setup guide for Android support in Bazzite.
Frequently Asked Questions¶
Check out the Bazzite FAQ.