Skip to content

Installation Troubleshoot Guide

Error Workarounds

Error Code 1

A generic error may appear during installation.

Watch this video for a workaround:

"Device is Active" Error

Watch this video for a workaround:

"Error checking storage configuration"

Watch this video for a workaround:

"Bad shim signature, you need to load the kernel first" error

Watch this video for a workaround:

See also: Secure Boot Guide

Worst Case Scenario: Alternative Installation Method

Attention

This method may have scaling issues with the installer depending on the hardware especially if it is a handheld PC.

The workaround below is also useful for downloading a smaller ISO size.

Rebasing from a Fedora Atomic Desktop Image

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 you prefer.

  1. The installation setup is similar to Bazzite and includes the same installer with the same instructions, but do not set a root account if its an option in the installer.

  2. 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.

  3. Open the terminal and enter this command, and keep in mind this process has no progress indicator and will take a long time.

  4. Reboot when the rebase has finished, and 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.

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

ujust _install-system-flatpaks

Choose the "Flathub" remote.

This command installs:

Rebasing to a signed image

Once everything is setup properly, then you should rebase from the unsigned image to the signed image for security reasons, so enter this command in the host terminal:

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

Replace <IMAGE> with the image you're using which can be found from the "Existing Fedora Atomic Desktop Users" section as well.

Video Tutorial