---
title: Bazzite Installation Guide
---
# Bazzite Installation Guide
## Video Walkthrough
https://www.youtube.com/watch?v=lBqbk6Z8HrQ
## System Requirements
- Read the [**Hardware Compatibility Guide**](/Gaming/Hardware_compatibility_for_gaming.md) for Bazzite's system requirements.
- Secure Boot and Trusted Platform Module (TPM) are supported on most hardware, but you must [**enroll our key during or after installation**](#secure-boot).
- [**Dual-booting with Windows is also supported**](#dual-booting-windows).
### Installer Requirements
- A way to download the Bazzite ISO
- A download manager (like [**Motrix**](https://motrix.app/)) if the direct download for the Bazzite ISO fails or is downloading too slow.
- A 16GB+ bootable medium like a Flash Drive
- Booting from a SD or microSD card may work, but not all firmware support this.
- One of the following programs to flash/boot the ISO:
- **Fedora Media Writer (recommended)** ([Windows/macOS](https://github.com/FedoraQt/MediaWriter/releases), [Linux](https://flathub.org/en/apps/org.fedoraproject.MediaWriter))
- **Rufus** ([Windows](https://rufus.ie/))
- **Ventoy** ([Windows, Linux](https://www.ventoy.net/)) (note: Ventoy needs [**extra steps for Secure Boot Support to work**](https://www.ventoy.net/en/doc_secure.html))
- A physical wired keyboard is **recommended** and **required for devices without a touchscreen**.
- An on-screen keyboard exists for scenarios where you do not have a physical USB keyboard.
- A touchscreen display or a mouse is required to navigate the installer properly.
### Desktop Environments
All of the images come with the choice of [**KDE Plasma**](https://kde.org/plasma-desktop/) or [**GNOME**](https://www.gnome.org/) for their desktop environment.
[**Steam Gaming Mode**](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) is an option as an additional session to run in addition to KDE Plasma or GNOME.
More information can be found on [**Bazzite's FAQ**](../../General/FAQ.md) about the differences between the image variants.
=== "KDE Plasma"
#### 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 (`-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"
#### Steam Gaming Mode (`-deck` images)
!!! note
Your device will automatically boot into the Steam Gaming Mode session at startup, and Desktop Mode can be accessed from the "**power menu**" in Steam Gaming Mode.
{% block desktop_envs_steam_notes %}
- **Requires a [Steam](https://store.steampowered.com/) account**
- Included in the [Bazzite-Deck images](/Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
- Interface is designed for handheld and couch gaming
- Controller friendly
- Choice of KDE Plasma or GNOME as the Desktop Mode session
- Extra functionality with [Decky plugins](https://github.com/SteamDeckHomebrew/decky-loader) [(See all plugins)](https://plugins.deckbrew.xyz/)
{% endblock %}
## Backup Device
Make sure to backup your personal data from the drive you plan to install Bazzite on to a safe place before proceeding with the installation.
## Download Bazzite
Download the Bazzite ISO of your choice. Choose the hardware you plan to install Bazzite on, the vendor of your primary GPU, the desktop environment of your choice, and if you want Steam Gaming Mode which is the Bazzite-Deck variant intended for HTPC setups and handheld hardware.
### Calculating ISO SHA256 Checksum Hash
**Video Tutorial**:
https://www.youtube.com/watch?v=wUDbMJtR1sM
## Flash ISO
Flash Bazzite to your bootable device using Fedora Media Writer and **eject the ISO afterwards**.
## Booting The Installer
- 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 key 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.
### Handheld Devices
Hold the 'Volume Down' (-) button and click the Power Button, and when you hear the chime, let go of both buttons, 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.
## Live Environment
Bazzite's live installer session lets you view the desktop applications pre-installed and get familiar with the UI/UX of it.
Please do not attempt to game on the live session since performance will not be accurate to when it is properly installed onto your drive.
Additionally, it is worth noting that the install environment does not include all of Bazzite's hardware support, (for example for the Steam Deck Audio), as it is running a different kernel than regular Bazzite.
### Network Setup in Live Environment
Please note that an internet connection is not required to install Bazzite, but is useful if you're testing Bazzite before testing in the live environment. **Open the Bazzite installer when ready to proceed with installation.**
## Select Your Language, Region, and Keyboard Layout
The first steps to installing Bazzite include selecting the system language, region for your time zone, and the layout of your keyboard for the correct input mapping.
## Partitioning Setup
!!! warning
Make sure to only select the appropriate drives to avoid losing data on others, and it is best practice to safely remove any external drives before proceeding.
Select the drive that you plan to install Bazzite on. Please note that this will wipe all of the data on the drive selected.
## Dual Booting Windows
!!! note
Skip this section if you plan to install Bazzite without dual-booting Windows.
!!! warning
The "format as efi" button when dual-booting says it will format the Windows EFI, but what it actually does is add itself to the EFI. This is an upstream bug with the installer.
If you are dual-booting with Windows then use automatic partitioning as it is the only option available in the live ISO, but it should work for most people's dual-booting usecases. If you require manual partitioning, then download the legacy ISO and follow the [**legacy ISO installation guide**](./legacy-install.md). For dual booting Windows on **separate** drives, use your motherboard's UEFI boot menu as the GRUB bootloader may not recognize each boot entry correctly.
### Video Walkthrough
https://www.youtube.com/watch?v=KAt49B6rSFI
### Written Walkthrough
1. Installing Bazzite with a shared drive.
2. Installing Bazzite on a separate drive.
=== "Shared Drive (Automatic Partitioning)"
1. (In Windows) Disable **Bitlocker encryption** and **fastboot**, and reboot.
2. (In Windows) Resize the Windows partition with the Disk Management app to have enough space for Bazzite.
Usually should look something like this:
Source: [diskpart.com](https://www.diskpart.com/windows-10/windows-10-disk-management-0528.html)
3. Run the Bazzite installer with the automatic partitioning option.
4. Reboot into Bazzite and run `ujust regenerate-grub` in the terminal to add Windows to the GRUB.
=== "Separate Drive"
**When a dedicated drive is feasible, this method is recommended.**
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).
If you install Windows second, you should disconnect the Bazzite drive to prevent using the Windows installer of using its EFI partition.
You can also install Windows to an external drive with Windows-to-Go using [Rufus](https://rufus.ie/en/) to dual boot if you do not have an internal drive available.
### Dual-booting other Linux operating systems
!!! note
Dual booting with **other Linux distributions**, especially **non-atomic Fedora**, is not officially supported. It is recommended to use your motherboard's UEFI boot menu or to forgo dual booting entirely to avoid unexpected issues. If something does go wrong, restore Bazzite's bootloader using the **Bootloader Restoring Tool** in the Live ISO.
For Fedora Atomic Desktop images on the **same** drive: to dual boot another **Fedora Atomic Desktop image** (like [Bluefin](https://projectbluefin.io/)) installed alongside Bazzite, you must make an additional EFI partition and switch between them through your motherboard's UEFI boot menu.
## Disk Encryption
!!! warning
It will not be possible to decrypt your drive and the data will be lost if you forget your encryption password!
Disk encryption is **optional** but is available via [LUKS](https://docs.fedoraproject.org/en-US/quick-docs/encrypting-drives-using-LUKS/). **You will need a physical USB keyboard to decrypt the drive!** Skip this step if you do not require disk encryption on this device. This isn't a necessary step for the most common scenarios unless you fear a bad actor will have access to your physical drive that Bazzite is installed on.
## User Account Setup
!!! warning
It is not recommended to enable a root account.
Create a username and a password to login to your Bazzite account. This password will also be used for any administrative privileges. **Make sure it is a password that you can remember**.
## Installing Bazzite
Review the changes that you are about to make in the installer. **Please read carefully before proceeding with the installation**. Please wait for Bazzite to install. This may take a while.
## Reboot
Reboot your device. You can now eject the flashable medium you used to install Bazzite out of your device once your device begins to boot up again.
## Secure Boot
!!! note
Skip this section if Secure Boot is not enabled or unsupported with your hardware.
!!! important
The enrollment prompt uses an English QWERTY keyboard layout, indiscriminately of your actual hardware keyboard. Other layouts can therefore interfere with the characters of the password (i.e. `A` and `Q` are swapped on AZERTY layouts).
Bazzite supports Secure Boot however Universal Blue's key must be enrolled to use it otherwise keeping Secure Boot on in your BIOS will result in Bazzite not booting.
### Important Secure Boot Notes:
- Entering the password will register invisible characters for security purposes, so you will not be able to see what you are typing!
- Updating your BIOS may re-enable Secure Boot and you may have to follow **"Method B"** after updating it to resolve the black screen on boot complaining about loading the kernel first.
- The Steam Deck does **not** come with secure boot enabled and does not ship with any keys enrolled by default, do not enable Secure Boot on your Steam Deck unless you absolutely know what you're doing.
### Error Message (if key is **not** enrolled properly):
```
error: ../../grub-core/kern/efi/sb.c:182:bad shim signature.
error: ../../grub-core/loader/1389/efi/linux.c:256:you need to load the kernel first.
Press any key to continue...
```
Follow **Method B** below to resolve this and move past the error message if you encounter it.
### **Method A** - During Installation Method
!!! note
This screen will also appear on the next boot if you enable Secure Boot if it was disabled during installation.
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**:
```command
universalblue
```
Otherwise `Continue boot` if you have Secure Boot disabled or if it is not supported with your hardware.
### **Method B** - After Installation Method
**Disable Secure Boot in the BIOS before proceeding**, 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**:
```command
universalblue
```
**You can now turn Secure Boot back on in the BIOS.**
Use the following command to boot straight into your system's BIOS (if supported):
```command
ujust bios
```
### Complete MOK enrollment at boot
On the next boot, you will see the blue MokManager screen:
1. Choose **Enroll MOK**.
2. When prompted for a password, enter:
```command
universalblue
```
After the reboot, the key is enrolled and Secure Boot can remain enabled. Your system should now boot normally under Secure Boot.
## **Troubleshooting Installation**:
Read the [**Troubleshooting Guide**](./troubleshoot_guide.md) or the [**Alternative Installation Guide**](./alternate-install-guide.md) for installation workarounds.
## Post-Installation
Bazzite is now installed. Read the [**Post-Installation Guide**](./post-installation.md) for recommended next steps!