Installation Troubleshoot Guide
ISO Workarounds¶
Error Code 1¶
A generic error may appear during installation.
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.
-
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.
-
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, 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.
-
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.