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
- 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 and open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
Workarounds / Known Issues
- Games can sometimes default to 800p resolution.
- Manually change the resolution per game in the
Steam Settings > Properties > Game Resolution
to eitherNative
or other higher resolutions.
- Manually change the resolution per game in the
- 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.
- Handheld Controller Glyphs theme for hhd & CSS Loader
- Open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
- Open a host terminal and enter this command:
- Handheld Controller Glyphs theme for hhd & CSS Loader
- 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.
- Manually change the resolution per game in the
-
- 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 eitherNative
or other higher resolutions.
- Manually change the resolution per game in the
- 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.
- Steam Input’s chords do not work by default.
- 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.
- Handheld Controller Glyphs theme for hhd & CSS Loader
- Open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
- Open a host terminal and enter this command:
- Handheld Controller Glyphs theme for hhd & CSS Loader
- 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 eitherNative
or other higher resolutions.
- Manually change the resolution per game in the
- 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
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.
- Handheld Controller Glyphs theme for hhd & CSS Loader
- Open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
- Open a host terminal and enter this command:
- Handheld Controller Glyphs theme for hhd & CSS Loader
- 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
- EnabledEnable 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 eitherNative
or other higher resolutions.
- Manually change the resolution per game in the
- 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.
- Run this script 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.
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
- Open a host terminal and enter the following commands:
(GitHub - ublue-os/akmods: A caching layer for pre-built Fedora akmod RPMs)). 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.
- Handheld Controller Glyphs theme for hhd & CSS Loader
- Open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
“Desktop Controls” section below)
- HDD’s support of both LEDs and Gyroscope is fine out of the box (with bmi260 from [ublue-os/akmod]
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 withrpm-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
- The script needs to be installed with Steam Deck/User Installation.
- 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 withrpm-ostree kargs --editor
.
- 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
- NVIDIA: currently untested
- AMD:
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.
- Handheld Controller Glyphs theme for hhd & CSS Loader
- Open a host terminal and enter this command:
ujust install-hhd-controller-glyph-theme
- Open a host terminal and enter this command:
- Handheld Controller Glyphs theme for hhd & CSS Loader
- 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 eitherNative
or other higher resolutions.
- Manually change the resolution per game in the
-
- 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.
- No internal audio in either Gaming Mode or Desktop Mode.
- Rotation is wrong in Desktop Mode for KDE images.
- Mouse input may break in Destkop Mode.
Other Handhelds
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)
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