Bazzite Handheld Wiki

Handheld Compatibility

This does not include all of our confirmed supported handhelds currently because we lack specific information regarding their post-installation setup and workarounds for them.

We took a similar approach to ProtonDB’s medal system, we give a label for each handheld that we support.

= Indicates Bazzite supports the hardware.

  • Platinum = No major issues and/or simple workarounds are needed for small fixes.
  • Gold = Minor issues and/or simple workarounds required, but ultimately works.
  • Silver = Major issues and/or exhaustive workarounds required, but boots and can game.
  • Bronze = Major issues and/or exhaustive workarounds, but boots and displays a desktop.
  • Borked = Bazzite does not boot on this hardware.
  • Unknown = The handheld is not listed here and a general guide is under “Other Handhelds.”

Steam Deck LCD (256GB+)

Status: Platinum

Post-Installation Setup

  • No additional setup required, but make sure to read the installation Guide.
  • It should function nearly identical to SteamOS with the benefits of Fedora Atomic Desktop:
    • Layer Fedora packages to the image without losing them between updates/reboots.
    • Newer package upgrades including the Linux kernel and drivers.
    • Printing support and other basic features that would make Bazzite viable for daily usage.
  • View our FAQ for more information.
  • Information regarding the differences between SteamOS and Bazzite on the Steam Deck can be found here.

Lenovo Legion Go

Status: Platinum

Post-Installation Setup

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Performance overlay might be reporting inaccurate power consumption.
  • Adaptive/auto display brightness is currently broken.
    • Manual brightness slider in Steam’s UI works without issues.
  • Experimental sound fix for higher resolution sound quality.
  • BIOS and controller firmware require Windows to update them.
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)
    • Legion L + X/Square (This can be remapped)

External Resource

For more information, check out the Legion Go Tips and Tricks guide which includes useful scripts for this handheld.


Ayn Loki Max

Status: Platinum

Post-Installation Setup

  • Open a host terminal and enter the following commands:
    • ujust setup-decky for Decky Loader (This can also be installed in the Bazzite Portal)
  • ujust setup-decky simpledeckytdp for SimpleDeckyTDP.
  • Install the CSS Loader Decky Plugin.
  • Optional: Adjust RGB with Steam Gaming Mode under Settings > Controller > Calibration & Advanced > LED Settings
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
      • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either “Native” or other higher resolutions.
  • Back buttons are hard mapped to L3 and R3.
    • This is also an issue on Windows.

ASUS ROG Ally

Status: Gold

Post-Installation Setup

  • Open a host terminal and enter the following commands:
    • ujust setup-decky for Decky Loader (This can also be installed in the Bazzite Portal)
  • ujust setup-decky simpledeckytdp for SimpleDeckyTDP.
  • Install the Handheld Controller Glyphs theme for hhd & CSS Loader.
    • Install the CSS Loader Decky Plugin.
    • Open a host terminal and enter this command:
    • ujust install-hhd-controller-glyph-theme
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)
    • There is no default keybinding for Steam’s on-screen keyboard. (Remap it to X or whatever you prefer)
    • Holding the Armoury Crate button (on the side) allows you to switch to Mouse Mode.
    • asusctl can be used for controlling fan speeds.

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Status of CPU Boost on Bazzite
    • Disable CPU boost to avoid excess power usage and other issues.
  • Changing A/C power sometimes leads to a stuck TDP.
  • LED is on max brightness by default and cannot be changed on any other operating system outside of Windows.
    • This is tied to the firmware.
    • This also affects when the ally is charging.
  • The Ally does not support button holding.
    • Steam Input’s chords do not work by default.
      • Swapping the Start/Select button(s) with them for them to work though.
  • Suspend can break if SMT is disabled
  • Current issues with the Ally’s BIOS may cause may cause the Ally to be stuck at 10w TDP, and won’t be able to change after suspending.
    • This does not occur using SimpleDeckyTDP with Ryzenadj.

GPD Win 4

Status: Gold

Post-Installation Setup

  • Open a host terminal and enter the following commands:
    • ujust setup-decky for Decky Loader (This can also be installed in the Bazzite Portal)
  • ujust setup-decky simpledeckytdp for SimpleDeckyTDP.
  • Install the CSS Loader Decky Plugin.
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)
    • Xbox + X (This can be remapped)
    • GPD devices also have a physical switch you can toggle to enable a separate desktop/mouse mode.

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Fix controls and gyro after suspend-resume cycles (confirmed to work on both the 7840u and 6800u variants).
    • Run these commands in a host terminal.

External Resource

For more information, check out the GPD Win Tips and Tricks guide which includes useful scripts for this handheld.


GPD Win Max 2

placeholder_gpdwinmax2

Status: Gold

Post-Installation Setup

  • Open a host terminal and enter the following commands:
    • ujust setup-decky for Decky Loader (This can also be installed in the Bazzite Portal)
  • ujust setup-decky simpledeckytdp for SimpleDeckyTDP.
  • Install the CSS Loader Decky Plugin.
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)
    • Xbox + X (This can be remapped)
    • GPD devices also have a physical switch you can toggle to enable a separate desktop/mouse mode
  • Steam Gaming Mode Display settings that are recommended to be changed:
    • Use Native Color Temperature - Enabled
    • Enable Unified Frame Limit Management - Disabled
  • Quick Access Menu Changes
    • Use the separated FPS limiter for limiting framerate.

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution
    • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Suspend/resume delay (The Win 4 gyro fix can also help odd suspend behavior on the Win Max 2)
    • Run this script in a host terminal.
      • Download it and mark it as executable in the file properties, and right click it to give the option to run in the terminal.

External Resource

For more information, check out the GPD Win Tips and Tricks guide which includes useful scripts for this handheld.


Steam Deck OLED

Status: Silver

Post-Installation Setup

  • No additional setup required, but make sure to read the installation Guide.
  • It should function nearly identical to SteamOS with the benefits of Fedora Atomic Desktop:
    • Layer Fedora packages to the image without losing them between updates/reboots.
    • Newer package upgrades including the Linux kernel and drivers.
    • Printing support and other basic features that would make Bazzite viable for daily usage.
  • View our FAQ for more information.
  • Information regarding the differences between SteamOS and Bazzite on the Steam Deck can be found here.

Workarounds / Known Issues

  • Similar to using Bazzite on the Steam Deck LCD, but currently suffers from the following:
    • Installer requires Basic Graphics Mode.
    • Switching to Desktop Mode causes the audio driver to crash especially when suspending the device.
    • HDR bugs for certain games and scenarios.

Ayaneo Geek 1S

Status: Silver

You will need this command for functional HHD:

sudo systemctl enable --now hhd@$(whoami)

Post-Installation Setup

Workarounds / Known Issues

  • Screen rotation is fixed with rpm-ostree kargs --append-if-missing=video=eDP-1:panel_orientation=right_side_up or editing the kernel command line with rpm-ostree kargs --editor.
  • Audio driver does work but needs to adjusted to support the 3.5mm jack.
    • Either install this rpm package that was created using this guide.
    • Alternatively, since ALC269VB is an audio chipset that has been around for years, it just need its pins to be rerouted with hdajackretask (part of fedora’s alsa-tools) package. (You basically need to reroute the auto-generated “green headset” and “black headset” devices to “Channel 30 & 31”).
    • External audio works over both HDMI and eGPU.
  • Suspend does not work.
    • The screen stays up and the fans spins, the device only supports S2IDLE and needs to be investigated more with this tool.
  • VRAM size option is missing from BIOS as it’s controlled by AYASPACE application under windows.

External Graphics:

  • eGPU Thunderbolt 3/4 over USB4 is supported. USB4 enclosure needs proper testing but there is no reason to suspect it should not work.
    • AMD:
      • Automatic switch at boot with all-ways-egpu works fine using method 2 and 3 at boot, unfortunately method 1 is not supported but seems to be related to gamescope session itself
      • In order to boot with eGPU attached you need to add a kernel parameter, seems to be related to this kernel issue. There are many other issues opened and according to this it could be potentially fixed in kernel 6.9. As a temporary solution booting with eGPU connected works when launching the command rpm-ostree kargs --append-if-missing=video=pci=nommconf or editing the kernel command line with rpm-ostree kargs --editor.
    • NVIDIA: currently untested

External Resource

Check out the original thread for more information and updates on this device.


Ayn Loki Mini Pro

Status: Silver

Post-Installation Setup

  • Open a host terminal and enter the following commands:
    • ujust setup-decky for Decky Loader (This can also be installed in the Bazzite Portal)
  • ujust setup-decky simpledeckytdp for SimpleDeckyTDP.
  • Install the CSS Loader Decky Plugin.
  • Virtual keyboard is Steam’s keyboard, but needs to be setup in Steam’s settings in Desktop Mode. (See “Desktop Controls” section below)

Workarounds / Known Issues

  • Games can sometimes default to 800p resolution.
      • Manually change the resolution per game in the Steam Settings > Properties > Game Resolution to either Native or other higher resolutions.
  • Audio driver does not currently work.
    • No internal audio in either Gaming Mode or Desktop Mode.
      • External audio is reported to have low sound quality.
  • Rotation is wrong in Desktop Mode for KDE images.
  • Mouse input may break in Destkop Mode.

Other Handhelds

handheld

Note: A few Ayaneo and OneXPlayer handhelds have been confirmed to boot Bazzite, but are plagued by missing driver support for Linux.

If your handheld hardware is not listed, then you can still give Bazzite a try with our Handheld/HTPC image.

Your mileage may vary with untested hardware. Whatever you find should be added to this wiki following our guidelines.

Bazzite does not have the required setup for unsupported handheld, so you may need to figure out what you need, but most importantly:

You will need this command for functional HHD:

sudo systemctl enable --now hhd@$(whoami)

HHD Information

How do I open the HHD Overlay?

Press, hold, or double-tap the Quick Access Menu button.

Example: Legion R for the Lenovo Legion Go.

Note: ASUS ROG Ally does not support holding and GPD devices do not support double-tapping.

Steam Gaming Mode Tips & Tricks

Read the Gaming Mode documentation for basic information on our Handheld/HTPC images.


Controller Information

For most handheld hardware, besides the Steam Deck, we emulate a DualSense controller for full functionality. Double tap or hold the side menu button to access settings for controller emulation including switching to an Xbox controller with reduced functionality.

If your device has paddles, you will want to use the DualSense Edge controller (excluding the Ayn Loki). It’s disabled by default because some games do not map it correctly.

Some games and emulators may need Steam Input disabled to work correctly with your controls.

Desktop Controls

Desktop Mode Controller Layout: It may not exist by default if Steam doesn’t setup your handheld controller properly. This can be fixed in Steam’s controller settings.

Make sure to apply the desktop controls when you select them.


eGPU Support

It’s complicated.

  • Modern AMD GPUs should work
    • Nvidia is unsupported
  • Proprietary connectors, like the one for the ASUS ROG Ally, are not going to work with Linux

Recommended script:


Need more information?

Check out the Gaming Mode documentation for more in-depth details and general fixes for Steam Gaming Mode.


Contributing

This page is a wiki, edit it to add any relevant information you may have regarding the handheld and your experience with Bazzite on it. Make sure to follow proper documentation guidelines and contributing guidelines before adding any edits.


Documentation Contributors: Antheas Kapenekakis, Aarron Lee, and Zetarancio

See also: Steam Deck, Handheld, & HTPC Images (Gaming Mode)

View all Bazzite documentation

1 Like