Skip to content
Authors:

Installation Troubleshoot Guide

ISO Workarounds

Error Code 1

A generic error may appear during installation.

Workaround Video Tutorial:

Device is Active Error

Watch this video for a workaround:

Alternative Installation Method

Attention: The workaround method may have scaling issues with the installer depending on the hardware especially if it is a handheld PC.

Note: 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 preferred.

  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:

  1. 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 which can be found from the "Existing Fedora Atomic Desktop Users" section as well.

Video Tutorial