1.2.0 (2023-09-28)
It is recommended that you flash this ISO with the Fedora Media Writer. Applications like Ventoy are known to have issues.
If you have previously used the DeckMTP plugin in Decky Loader on SteamOS, be sure to disable Dual-Role USB in the Steam Deck BIOS, otherwise you will not be able to boot to USB storage. It can be re-enabled after installing Bazzite.
Make sure you check out the Frequently Asked Questions
Users with Secure Boot enabled must enroll our signing key
just enroll-secure-boot-key
Enter the password ublue-os
if prompted.
Warning
Due to an upstream bug, Bazzite cannot be used on Steam Decks with 64GB eMMC storage at this time. Upgrading the storage resolves the issue.
Warning
Handheld users: be sure to remove your SD card during install to avoid making unintended changes to it.
Warning
Dual booting with SteamOS or other Linux distributions is not supported.
Important
These are online ISOs. A stable network connection is required. We recommend using a dock if available.
Note
A helpful install guide can be found here.
Features
- Add a helpful message to bash for common secure boot & Nvidia user issues. (98083aa)
- Add a just command to fix SteamVR on desktop releases (442e0c4)
- Add a script for fixing tcmalloc for TF2 (35beec0)
- Add fix-screenshare command to just and yafti. (db4bd53)
- Add Gear Lever flatpak for managing AppImages (9a1c0cf)
- Add gnome-randr (f3347f1)
- add handygccs (258950d)
- Add image info for auto-signing via ublue-update (a30a8f9)
- Add just command for disabling sdgyrodsu (5c068a5)
- Add just command for enabling theme integration with flatpak applications (22cfe77)
- Add just command to disable uBlue gamepad drivers if desired (Thanks lorduskordus) (713e6ac)
- Add just commands for toggling broadcom-wl (2e0e250)
- add link to FAQ to the README (5a3f3ee)
- Add missing package for KDE color control (Except on Nvidia) (554849b)
- Add nct6687 driver for lm_sensors on certain AMD B550 motherboards. (0beb62f)
- Add nix garbage collector to just clean-system (11c89fd), closes #300
- Add obs-studio-portable installer to just (0c4bee5)
- Add OpenRazer to Just and Bazzite Portal (66bb01b)
- Add option to install Fleek when installing Nix (217a432)
- Add option to install Oversteer to Bazzite-Portal (b9d3b5f)
- Add oversteer-udev to allow oversteer without layering (443fc8d)
- Add PinApp to Bazzite Portal (4db9a4c)
- Add required input user group in Bazzite Portal by default (b57ff42)
- Add ROM Properties Page shell extension (https://github.com/GerbilSoft/rom-properties) (12aba57)
- Add Ryzen SMU driver, load automatically on Deck builds (1e28468)
- Add scrcpy to just and yafti (86ac62b)
- Add support for Surface devices (afb1665)
- add table of contents section to README (4db7c82)
- Add Tailscale VPN support OOTB (b5cd84d)
- Add twemoji fonts, matching SteamOS (71ee71a)
- Add Web App Manager, OpenRazer, Oversteer, Solaar, and Resilio Sync (1ed5421)
- Add wmctrl, useful for resizing windows under gamemode/gamescope (f70ef09)
- Added showcase section and linked blog posts. (7e47486)
- Allow discover-overlay auto-launching to be disabled (and default disable) due to conflict with mangohud (36e073b)
- bazzite-autologin: Merge gamescope and desktop autologin (967d525)
- deck-gnome: Add templates for vkBasalt and DXVK to make game modding easier, allows for creation of the example config from the right click menu (1e1437a)
- deck: Add calibrated color profiles for matte & reflective Steam Deck displays. (3e38000)
- deck: Add default-enabled option to disable TDP and other hardware controls on non-deck hardware. See /etc/default/steam-hardware-control (484fa80)
- deck: Add discover overlay, auto launches on desktop and gamemode if Discord is installed (61266b0)
- deck: Add disk display to neofetch (09559a8)
- deck: Add equalizer settings for mic from SteamOS (6bd7248)
- deck: Add just command to disable deck-hardware-specific services (just disable-deck-services) (a19ae1f)
- deck: Add just commands to disable bios updates & controller firmware updates if desired (30905ea)
- deck: Add loopback audio source (b78e0d2)
- deck: Add service to return to gaming mode (64ef129)
- deck: Add wxGTK dependency for Lutris's PCEM (00ccc68)
- deck: Disable PEERNTP to ensure NTS is always used (9852651)
- deck: Implement desktop autologin toggle (aad1037)
- deck: Restore ddccontrol (7e6ae0d)
- deck: Restore KRFB packages (No space is saved removing them) (658aa0c)
- deck: Switch bios updates to being default disabled, these will be enabled by Yafti at launch instead so they may be opted out of. (3fd3ee5)
- deck: Switch to native version of Protontricks (f387447)
- deck: Use librnnoise params from SteamOS (c4fb899)
- deck: Use new powerbuttond daemon from upstream SteamOS (676cfdd)
- desktop: Add discover-overlay matching deck builds (Default disabled, see /etc/default/discover-overlay) (7fff9de)
- desktop: Add reset-bazzite-arch just command to completely remove the image and pull it fresh. (de25c72)
- Enable builds without kmods (6623191)
- Explicitly use xxhash for duperemove and rmlint (df322bf)
- flatpak-system-install: Improve flatpak management (23cf933)
- gnome: Add automatic updates for Firefox GNOME theme and Thunderbird GNOME theme (If installed) (074365a)
- gnome: Add gamerzilla gnome extension (0dd8ace)
- gnome: Add Hanabi, an extension for using videos as wallpapers. This is similar to KDE's Wallpaper Engine integration. (86fd1c1)
- gnome: Add just command for installing Adwaita-for-Steam, update theme with ublue-update automatically when present (cc662ab)
- gnome: Add steam soundfont when selecting a Valve-inspired theme (35ff5d4)
- gnome: Add tailscale status gnome shell extension (8047e20)
- gnome: Add totem video player flatpak (d4c3478)
- gnome: Enable symlink creation context menus and show folders first by default (30b377b)
- gnome: Restore AdwSteamGtk flatpak (526be6a)
- gnome: Set default fonts in GNOME to match SteamOS KDE session (0145cfb)
- gnome: Set flat mouse accel profile on deck (Matches SteamOS behavior on KDE) (79957ad)
- gnome: Use new bazzite-arch-gnome image, far faster initial setup than making these same changes on init. (9746f60)
- gnome: Use ProtonPlus over Protonup-Qt on GNOME builds. Same feature set, more consistent UI. (138e479)
- hardware-setup: Enable amdgpu on supported systems (aea93df)
- Include Mission Center (a8ed723)
- Increase vm.max_map_count to match SteamOS (131490d)
- Install broadcom's WL driver needed by some hardware. This is default disabled due to it breaking other wifi hardware. (8536117)
- just: Add script that signs the current image (e6b8cd9)
- just: add waydroid-related utilities (ee151aa)
- just: Use image identifiers for signing (5823866)
- Launch discover-overlay on KDE Wayland since it's supported (4790e60)
- patch-gmod: Always use latest version (c9df8ca)
- reduce boot times by creating donefiles w scripts in desktop version (d6667e8)
- Replace neofetch with more maintained hyfetch (Still available in terminal as neofetch) (1a36315)
- Restore discover overlay support (1efe712)
- steamos-update: Use service to run rootful updates (4657994)
- Switch to new numbered just file system (81bb600)
- Switch to using dedup service from SteamOS-BTRFS (a0c9f84)
- Use determinate systems nix installer (8d7f2ef), closes #209
- user-setup: Enable NTP by default (825d69c)
- yafti: Sign Bazzite during installation (3729cf6)
Bug Fixes
- Add HandyGCCS to Deck images (e5a487d)
- add intel support for HTPC deck images (eb32cba)
- Add missing dependency for SteamTinkerLauncher (1e161b6)
- add more examples (4d49d60)
- Add pulseaudio-utils for pactl, used by some 3rd party applications. (7c82fbe)
- Add workaround for hardcoded font path in Steam (Thanks szescxz) (7dd9580)
- Avoid copying the akmods repo a 2nd time needlessly (651f698)
- bazzite-autologin: Always remove Steam's autologin config when triggered (a758977)
- build: Remove PR tagged images (c679417)
- check donefiles in system services + do not check flatpak donefile (9452a41)
- condition checked at proper key in bazzite-hardware-setup systemd service (4f3f9db)
- Correct issue where bazzite-arch updater fails if you're using a bazzite-arch image at a non-default name (3621027)
- Correct issue with bazzite-hardware-setup executing every launch. (403547d)
- Correct issue with Boilr installer if ~/.local/share/applications doesn't exist (5c068a5)
- Correct issue with patch-gmod just command (bfb53a7)
- Correct issues with just command, lists by default and works in fish no matter working directory (6e4cb37), closes #271
- Correct missing icon in Lutris on bazzite-arch - Fixes #262 (0c4bee5)
- deck: Add audio firmware from Valve (e567213)
- deck: Add LibFAudio dependency for Lutris (be0dd07)
- deck: Add needed packages for Chinese input (Thanks szescxz) (efe06f2)
- deck: Add workaround from ChimeraOS for gamescope crashing if Steam hasn't been launched & updated prior to switching to gamemode. (f769813)
- deck: Adjust shortcut to trigger service to return to gaming mode (2c391a4)
- deck: Correct ibus path in steamdeck-kde-presets (b028b53), closes #210
- deck: Disable desktop-autologin from gamescope-autologin directly (975986f)
- deck: Enable gamescope-autologin by default (ebfd978)
- deck: Launch Steam with -steamdeck to prevent Steam re-install when switching to gamemode, and (potentially) allow beta client selection. (471c7bc)
- deck: Make fix-tf2-tcmalloc SD card aware (67813d6)
- deck: Mask rather than disable bios update services (13289ca)
- deck: Only enable HandyGCCS in gamescope session (c9d4b5d)
- deck: Only launch steam with -steamdeck if it's been run & updated at least once. (df9b89f), closes #214
- deck: Reduce max volume now that firmware is working (7f28345)
- deck: Remove Deck TDP control udev rules if deck hardware isn't detected to avoid running into 15W limit from Steam (2fa0e15)
- deck: Remove duplicated disablement of nonfree-updates before installing Steam (d254c94)
- deck: Remove now unneeded environment variable (9addffb)
- deck: Sleep ryzenadj service for 10 seconds to ensure changes are applied when resuming from suspend. (74b1432)
- deck: Switch back to X11 by default while issues with special characters via Steam Keyboard are resolved (bfd0cd0)
- deck: Use 3d fullscreen gpu profile on deck builds (1326c19)
- deck: Use volumes from SteamOS (3265a68)
- decky: Preserve service during upgrades (ff202a4)
- desktop: Break up export command for SteamCMD (24a8945)
- desktop: Clean up desktop file creation, change big picture mode to autologin only. Enable start steam in big picture mode in Steam settings if you want the previous behavior. (0c70cc5)
- desktop: Fix syntax error in CoreCtrl setup script (1558ecd)
- desktop: Generate locales during distrobox setup (a6b34d3)
- desktop: Only use X11 by default on deck builds (e04b73c)
- desktop: Remove Memory Tuning option from Bazzite Portal on the desktop (cdd0372)
- desktop: Restore autostart, fix big picture mode just/yafti command (698213d), closes #183
- desktop: Temporarily remove autostart while distrobox bug is worked out (f2cd00d)
- desktop: ublue-update.timer is a system service now (da98c83)
- desktop: Use distrobox create over distrobox assemble due to reported issues, ensure output is visible in Bazzite Portal. (2cf7a2f)
- desktop: Use yes instead of pull to speed up repeat bazzite-arch creations. (341ebc0)
- Disable generic handheld builds (c24ae27)
- Don't explicitly check main when excluding Nvidia (7c30803)
- Exclude Bazzite kmods from nokmods images (124d2cc)
- fish: Add alias for just command to enforce --unstable (f230ea2)
- Fix configure_waydroid just script (2bdf03c)
- flatpak-system-install: Ensure Bazzite config directory exists before writing version (abaafa3)
- flatpak-system-install: Re-remove Deck install list (65deb11)
- flatpak-system-install: Ship flatpak lists in /usr (847c9d7)
- fleek: Run fleek install script as user, let it req sudo as needed. (f01ef05)
- gamescope-autologin: Only configure autologin if Steam has updated (34ca801)
- gnome: Override new mutter-common package (88c6bbc)
- gnome: Remove appindicator extension that breaks VRR (Also updates Search Light defaults and fixes Bazzite-Menu so it launches Steam with extest applied) (ea7d053)
- gnome: Remove gnome extensions rpm, this is replaced with mjakeman's flatpak (8cf5283)
- gnome: Remove non-working caffeine extension (fe5a66f)
- gnome: Remove unneeded GNOME Extensions flatpak (f64d9d2)
- gnome: Remove unneeded GNOME Extensions flatpak even if preinstalled (838e553)
- gnome: Restore yelp (help) (efe06f2)
- gnome: Set sensible default power settings on Steam Deck hardware automatically (2334719)
- HandyGCCS missing depdency (3bd2656)
- Hard code path instead of using systemd-escape to fix issue with btrfs-dedup timer (31fda32)
- hardware-setup: Correctly check image name (10886b8)
- hardware-setup: Disable Deck services on generic devices (4edac4a)
- hardware-setup: Disable sdgyrodsu immediately (b6976b6)
- hardware-setup: Disable sdgyrodsu on generic devices (0d2d62d)
- hardware-setup: Don't remove amdgpu kargs when no longer in use (1f8c80f)
- hardware-setup: Set image flavor (97e74f3)
- image info: use proper prefix in IMAGE_REF (c7bd4b7)
- image-info: Don't wrap identifiers in quotations (019704d)
- install-bazzite-arch: Use sh instead to get output in yafti (87e851b)
- install-fleek: Ensure $HOME gets set properly (95b75da)
- just: Use image info consistently (0b7532a)
- just: Wait for any existing transactions to complete before invoking rpm-ostree (7889e2e)
- Make sure files don't exist before copying or symlinking in bazzite-user-setup, allows re-runs without any errors printed. (24ac50f)
- make sure flatpak install script does not run if already installed (97fab17)
- Make sure nix is installed first in fleek install script (c4e0c99)
- Modify bazzite-user-setup to match bazzite-hardware-setup in ability to re-launch as needed (403547d)
- Modify xdg-desktop-portal service to auto-restart to work around bug reported in KDE (f0a3b0b)
- Mount icons & themes folders in bazzite-arch (09ef663)
- Move extest back to desktop image to leave it as an option. (3ffcbf1)
- outdated link to secure boot/nvidia information (4803882)
- Override mesa-libEGL-devel due to dependency on it in kde-wallpaper-engine (6952d8b)
- Pass --no-confirm to nix install script (dcf968d)
- Replace additional udisks2 packages (038c2ae)
- sign-image: Pull current image from rpm-ostree and fallback to image identifiers (b62722d)
- sign-image: Use package screen instead of consent screen (e286929)
- steamos-update: Don't trigger updates while checking (thanks Chimera!) (c137d1b)
- steamos-update: fix updates not applying (978e0de)
- steamtinkerlauncher: Add xrandr dependency (22689fd)
- treewide: Use new image info implementation (66a14d3)
- Use system level alias for Fish shell (73f267c)
- user-setup: Ensure user always has working justfile (d39adf7)
- yafti: Don't sign image if its already been signed (2916d9a)
- yafti: Remove steam.desktop with -f to prevent error from being printed if it doesn't exist (09062f9)