Bazzite Inital Setup and Installation for General Desktop and Laptop Hardware

Pre-Installation

Minimum System Requirements

  • Architecture: x86_64
  • Firmware: UEFI (CSM Support should be disabled if available)
  • Processor (CPU) : 2GHz quad core processor or better
  • System Memory (RAM): 4GB
  • Graphics: A graphics card that can utilize Vulkan 1.3+
  • Storage: 50GB free on an internal solid-state drive
  • Network: Stable internet connection with no bandwidth caps
  • Additional Notes: Certain drivers are not compatible with Bazzite.

Installer Requirements

  • A USB flash drive with 10GB free space
    • Note: All data on this drive will be wiped when flashed
  • Software to flash the image:
  • Physical keyboard

Desktop Environments

Bazzite comes with the choice of KDE Plasma or GNOME for the desktop environment.

Steam Gaming Mode is an option and if you opt to use it, then this installation guide no longer applies and it is recommended to read the HTPC installation guide instead.

More information can be found on our FAQ about the differences between the image variants.

KDE Plasma (Default)

  • KDE Plasma’s default interface has a traditional and familiar layout
  • Highly customizable with tons of settings
  • Qt framework
  • Popular Linux distributions like SteamOS use KDE Plasma

GNOME (-gnome images)

  • GNOME’s default interface has an elegant and touch-friendly layout
  • Simple and concise
  • GTK framework
  • Popular Linux distributions like Ubuntu use GNOME

Steam Gaming Mode (-deck images)

Note: Your device will automatically boot into the Gaming Mode session at startup, and Desktop Mode can be accessed from the “power” menu in Gaming Mode.

  • Requires a Steam account
  • Included in the Handheld/HTPC images
  • Interface is designed for handheld and couch gaming
  • Controller friendly
  • Choice of KDE Plasma or GNOME in Desktop Mode
  • Extra functionality with Decky plugins

Dual Boot Preliminary Setup

Two Methods: Method A or Method B

  • A) Installing Bazzite on a separate drive (Recommended)

  • B) Manual partitioning on the same drive

A) Separate Drive Method

Install Bazzite on a separate internal or external drive.

  1. Install the other operating system on a drive (like Windows)
  2. Install Bazzite on a second drive
  3. Set Bazzite as the default in your boot order (optional)

You can also install Windows to an external drive with Windows-to-Go using Rufus to dual boot if you do not have an internal drive available.

B) Same Drive Method

Note: This must be done before installing Bazzite.

If you do not have multiple drives or are using a device that will not be stationary, then you will have to manually partition on the same drive.

Note about dual booting with Windows specifically:

Dual booting Bazzite with Windows on the same drive works better with Windows already installed before Bazzite.

Bazzite Partition

Create space for Bazzite with the Disk Management application in Windows.

Win + R to open Windows Run and enter:

diskmgmt.msc

Then, right-click your Windows partition and select “Shrink Volume” from the drop-down menu. Afterwards, select how much storage you want to allocate for Bazzite.

You will most likely have an EFI partition that already exists if you are dual booting with Windows, so you don’t need to make another one. However, you have to select it, then click the ‘cog’ icon, followed by “Set Mountpoint” in the drop-down menu. Set it to /boot/efi .

Installation Guide

1. Download and Flash Bazzite

  • Download Bazzite after choosing the correct ISO for your hardware with our Image Picker tool.
  • Flash Bazzite to your bootable medium.
  • Eject drive.

Current Fedora Atomic Desktop Users

Current Fedora Atomic Desktop users can rebase with the terminal command listed on the website under the “Existing Fedora Atomic Desktop Users” section and can skip the next step.

2. Boot Bazzite

  • Connect your bootable medium to your device and boot into it.
  • After connecting the device, boot into the Bazzite installer.
  • This depends on your motherboard hardware, but most of the time it could be a function keys like F9 or similar.
    • Sometimes you need to consult the manual, look up your device online, or read any hotkeys that appear when you boot your PC.
      • Alternatively change the BIOS settings to boot with your bootable device first before your current storage, but this is not recommended to keep enabled after installing Bazzite.
  • Verify the media correctly and proceed to the installer.

3. Installer

  • Select your language, region, keyboard layout, and time zone.
  • Select the drive that Bazzite is going to be installed on.
    • Delete any partitions that you have remaining on the drive unless dual booting on the same drive.
    • Recommended to use the automatic storage configuration unless dual booting on the same drive.
  • Optionally encrypt the drive with a password if desired.
    • If you lose this password, then it cannot be decrypted.
  • Setup a user account.
    • Give administrative privileges and set a user password.
  • Begin the installation.
  • Reboot device after it has finished installing.

Manual Partitioning to the Same Drive for Dual Boot Setups

  1. Select Installation Destination

  2. Select Advanced Custom(Blivet-GUI) under Storage Configuration.

  3. Create partitions and devices:

    Manual Partitioning Scheme:
    
    mount point: /boot/efi  
    format:      EFI system partition
    size:        300MB  
    (optional: use existing system EFI partition)
    
    mount point: /boot
    format:      ext4
    size:        1GB
    
    mount point:
    format: btrfs
    size: [max]
    
    mount point: /
    format:      btrfs (subvolume)
    
    mount point: /var
    format:      btrfs (subvolume)
    
    mount point: /var/home
    format:      btrfs (subvolume)
    

Note about dual booting other Fedora Atomic Desktop images on the same drive

If you want to dual boot another Fedora libostree image (like Bluefin) installed alongside Bazzite, then you would have to make an additional EFI partition and switch between them through the BIOS boot menu.

Important information for users with Secure Boot enabled:

Note: Skip this section if Secure Boot is not enabled or unsupported with your hardware.

Method A) During Installation Method (See Image Above)

A blue screen will appear giving the option to enroll the signed keys after leaving the Bazzite installer.

Enroll MOK if you have secure boot enabled. If prompted to enter a password, then enter:

ublue-os

Otherwise Continue boot if you have Secure Boot disabled or if it is not supported with your hardware.

Method B) After Installation Method

ATTENTION: Disable Secure Boot before doing this, and then re-enable it after enrolling the key.

If you have already installed Bazzite then enter this command in a host terminal:

ujust enroll-secure-boot-key

If prompted to enroll the required key, then enter the password in the host terminal:

ublue-os

You can now turn Secure Boot back on in the BIOS.

If you’re rebasing from a Fedora Atomic Desktop image and use Secure Boot, then follow our README.


Post-Installation

GRUB Menu

The first boot will show a screen showing your current and last deployment. It will automatically boot if nothing. It is important to note that the GRUB menu can be used to rollback Bazzite deployments if you encounter issues.

Read more about this in the Updates, Rollback, and Rebasing documentation.

Configuring System Settings for KDE Plasma and GNOME


KDE Plasma’s System Settings application


GNOME’s Settings application

It is important to configure the system settings on a first boot to personalize your desktop especially if you notice the scaling is incorrect on first-boot.

First Boot Setup Utility: Bazzite Portal

Attention: Make sure you are connected to the internet.

An application will pop up welcoming you to Bazzite when you boot into the desktop for the first time. This is a utility that allows you to tailor Bazzite to your liking by installing additional software.

  • 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 would like to customize any of the options, then press the arrow next to the toggle switch button if available.
  • Installing items from the portal may take a long time.

Note: If you only check a few items in a category, then it will only install those selected items. The switch is only toggled to install everything in that category.

Attention: There is a rare chance you will be asked to setup KDE Wallet or GNOME Keyring and set a password to continue installing items from the Bazzite Portal.

Installing additional software

The Installing and Managing Applications documentation is useful to learn how to install additional software on Bazzite outside of the Bazzite Portal.

Dual Boot Post-Configuration Setup

Regenerate GRUB to show Windows Entry

If you do not see your Windows boot in the GRUB menu, then open a host terminal and enter:

ujust regenerate-grub

Bazzite as Primary Boot

If the OS Boot Manager has set Windows Boot Manager to be the first boot priority, then this may result in booting directly into Windows after the install instead of Bazzite. You may have to fix this in your BIOS settings.

Ready to Game

You have now installed Bazzite!

View our Gaming Guide for a quick rundown of Linux gaming, useful resources, and setting up Proton on Steam.

Check out the additional documentation surrounding the project.


Video Tutorial

Windows 11 Dual Boot Setup w/ Secure Boot Enabled:


ISO Workarounds / Alternative Installation Methods

Note: Ignore this part of the guide if Bazzite installed properly on your hardware.

Attention: Both workarounds may have scaling issues with the installer depending on the hardware.

Important: Also note that the workarounds are useful for downloading a smaller ISO.

Generic Installer Error Workarounds

Option 1: Rebasing from a Fedora Atomic Desktop Image (Recommended)

If you experience issues with installing our ISO or the bootable drive you have is too small for Bazzite, then download the Fedora Kinoite (KDE Plasma) or Fedora Silverblue (GNOME) depending on which desktop environment preferred.

The installation setup is similar to Bazzite and includes the same installer with the same instructions.

Once installed, you will not be on Bazzite until you enter the command found on our website that appears under “Existing Fedora Atomic Desktop Users” section when the download is ready.

Open the terminal and enter this command, and keep in mind this process has no progress indicator and will take a long time. Reboot when the rebase has finished. Bazzite should be installed after rebooting and your username as well as the user password will carry over from the upstream Fedora Atomic Desktop to Bazzite.

You will also be missing the default applications until you open a host terminal and enter:

ujust _install-system-flatpaks

This command installs:

Once everything is setup properly, then you need to rebase from the unsigned image to the signed image, so enter in a host terminal:

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/<IMAGE>

Replace <IMAGE> with the image you’re using.

Video Tutorial

Option 2: Older & Buggy Net-Installer (Not Recommended)

Note: This is intended as a last resort!

This is not something we recommend at all, but an alternative solution is using our Github release of the last online ISO. This is extremely buggy and suffers from other issues that are now fixed in the offline ISO.

There is an older video showcasing how to install the Bazzite with this old online ISO.

IMPORTANT: The video guide does not mention this part of the process since this wasn’t a requirement previously:

  • After installing it and making it to the desktop, then you will have to rebase to our stable build.
  • The command can be found on the website appropriate for your hardware and specific image you downloaded under “Existing Fedora Atomic Desktop Users”, and keep in mind rebasing has no progress indicator and takes a long time.
  • Reboot when the rebasing process has finished, and you will know because it will tell you to reboot your device.

You will also be missing the default applications, so open a host terminal and enter:

ujust _install-system-flatpaks

This command installs:


Documentation Contributors: Kyle Gospodnetich, Nathaniel Warburton, Jorge Castro, Noel Miller, ChaiQi, Damian Korcz, and Justin Garrison

See also: Upstream Manual Partitioning Guide & Auto-Mounting Secondary Drives

View all Bazzite documentation