# ublue-os/bazzite

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ublue-os-bazzite).**

7,876 stars · 729 forks · Shell · apache-2.0

## Links

- GitHub: https://github.com/ublue-os/bazzite
- Homepage: https://bazzite.gg
- awesome-repositories: https://awesome-repositories.com/repository/ublue-os-bazzite.md

## Topics

`desktop` `fedora-kinoite` `fedora-linux` `fedora-silverblue` `gaming` `htpc` `legiongo` `oci-image` `operating-system` `ostree` `rog-ally` `steam` `steam-deck` `valve`

## Description

Bazzite is an immutable, atomic-image-based operating system designed for gaming performance and handheld hardware. It utilizes a read-only root filesystem and versioned images to provide atomic updates and instant system rollbacks, ensuring a stable core environment.

The system is distinguished by its deep optimization for portable gaming devices, featuring dedicated handheld hardware management for CPU undervolting, fan control, and display refresh rate overclocking. It includes a specialized gaming mode that boots directly into a console-like interface with integrated input mapping and a tuned compositor for visual stability.

Bazzite covers a broad range of capabilities, including Windows game compatibility through translation layers, containerized application workflows for isolated software execution, and comprehensive hardware driver configuration for GPUs and peripherals. It also incorporates advanced storage management via BTRFS for filesystem compression and automated secondary drive mounting.

Security and system integrity are maintained through cryptographically signed image validation, TPM-backed storage security, and Secure Boot public key enrollment.

## Tags

### Operating Systems & Systems Programming

- [Handheld Gaming Operating Systems](https://awesome-repositories.com/f/operating-systems-systems-programming/handheld-gaming-operating-systems.md) — Provides a specialized immutable operating system tailored for portable gaming devices with integrated hardware and UI optimizations.
- [Immutable Operating Systems](https://awesome-repositories.com/f/operating-systems-systems-programming/immutable-operating-systems.md) — Provides a read-only root filesystem and versioned images to ensure a stable, consistent system state. ([source](https://github.com/ublue-os/bazzite/blob/main/README-ID.md))
- [Application Installation Portals](https://awesome-repositories.com/f/operating-systems-systems-programming/application-installation-portals.md) — Implements a comprehensive software installation system using graphical portals and containerized package managers. ([source](https://docs.bazzite.gg/))
- [Atomic System Updates](https://awesome-repositories.com/f/operating-systems-systems-programming/atomic-system-updates.md) — Implements an operating system update mechanism that applies changes as a single, indivisible operation.
- [Atomic Image Rebasing](https://awesome-repositories.com/f/operating-systems-systems-programming/atomic-system-updates/atomic-image-rebasing.md) — Switches the underlying system image between different variants without losing user data. ([source](https://github.com/ublue-os/bazzite/blob/main/README-BR.md))
- [Gaming Mode Boot Sequences](https://awesome-repositories.com/f/operating-systems-systems-programming/gaming-mode-boot-sequences.md) — Boots directly into a console-like interface with integrated input and custom fan control. ([source](https://github.com/ublue-os/bazzite/blob/main/README.md))
- [Gaming OS Deployments](https://awesome-repositories.com/f/operating-systems-systems-programming/gaming-os-deployments.md) — Installs a pre-configured immutable environment on hardware to ensure compatibility and gaming performance. ([source](https://docs.bazzite.gg/))
- [Handheld Hardware Support](https://awesome-repositories.com/f/operating-systems-systems-programming/handheld-hardware-support.md) — Provides specialized drivers, fan controllers, and firmware updates specifically for portable gaming hardware. ([source](https://github.com/ublue-os/bazzite/blob/main/README-RU.md))
- [Hardware Drivers](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-interfacing-drivers/hardware-drivers.md) — Installs proprietary drivers and specialized support for GPUs, controllers, and RGB peripherals. ([source](https://github.com/ublue-os/bazzite/blob/main/README-ID.md))
- [Immutable Host Layering](https://awesome-repositories.com/f/operating-systems-systems-programming/immutable-host-layering.md) — Bazzite installs local binaries directly onto the immutable host for tools that cannot run in containers. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/))
- [Input Device Emulation](https://awesome-repositories.com/f/operating-systems-systems-programming/input-device-emulation.md) — Maps handheld controls to standard controller profiles for compatibility with games and emulators. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/))
- [Operating System Image Deployments](https://awesome-repositories.com/f/operating-systems-systems-programming/operating-system-image-deployments.md) — Manages the deployment and versioning of full operating system images on hardware. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/))
- [Image Rebasing](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/base-image-distributions/image-rebasing.md) — Switches the underlying operating system image between different variants while preserving user data.
- [Windows Compatibility Layers](https://awesome-repositories.com/f/operating-systems-systems-programming/windows-compatibility-layers.md) — Provides the necessary infrastructure to run Windows-based games on a Linux-based immutable OS. ([source](https://docs.bazzite.gg/Gaming/Game_Launchers/))
- [Update Stream Switching](https://awesome-repositories.com/f/operating-systems-systems-programming/atomic-system-updates/update-stream-switching.md) — Allows switching the current system build or update branch to a different image version. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/bazzite_rollback_helper/))
- [BTRFS Filesystem Management](https://awesome-repositories.com/f/operating-systems-systems-programming/btrfs-filesystem-management.md) — Utilizes BTRFS to support transparent compression, deduplication, and automatic secondary drive mounting.
- [Linux Distribution Container Execution](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-linux-distributions/linux-distribution-container-execution.md) — Executes minimal variants of various Linux distributions within isolated containers. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Distrobox/))
- [Desktop Environments & UI](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-environments-ui.md) — Provides the ability to choose between different desktop environments or a dedicated gaming session. ([source](https://docs.bazzite.gg/General/Installation_Guide/install-guide/))
- [Display Compositors](https://awesome-repositories.com/f/operating-systems-systems-programming/display-windowing/display-compositors.md) — Uses a specialized display compositor to manage framerate caps and resolution scaling for visual stability. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Steam_Gaming_Mode/))
- [Gaming Compositor Tuning](https://awesome-repositories.com/f/operating-systems-systems-programming/display-windowing/display-compositors/gaming-compositor-tuning.md) — Adjusts display and windowing behavior for games by tuning the Gamescope gaming compositor. ([source](https://docs.bazzite.gg/Advanced/))
- [Refresh Rate Controls](https://awesome-repositories.com/f/operating-systems-systems-programming/display-windowing/display-configuration-services/refresh-rate-controls.md) — Adjusts screen refresh rates beyond factory defaults using environment variables. ([source](https://cdn.jsdelivr.net/gh/ublue-os/bazzite@main/README.md))
- [Game Launch Presets](https://awesome-repositories.com/f/operating-systems-systems-programming/game-launch-presets.md) — Bazzite uses shorthand commands and presets to apply complex environment variables when starting games. ([source](https://docs.bazzite.gg/Gaming/launch-options-env-variables/))
- [Game Storefront Integrations](https://awesome-repositories.com/f/operating-systems-systems-programming/game-storefront-integrations.md) — Integrates external launchers and frontends to manage games from various digital stores. ([source](https://docs.bazzite.gg/Gaming/gaming-intro/))
- [Gaming Utility Integrations](https://awesome-repositories.com/f/operating-systems-systems-programming/gaming-utility-integrations.md) — Integrates specialized tools including emulators, plugin loaders, and device drivers for an enhanced gaming experience. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Bazzite_Portal/))
- [GPU Switching Automations](https://awesome-repositories.com/f/operating-systems-systems-programming/gpu-switching-automations.md) — Automates the transition to a discrete GPU on laptops to ensure maximum gaming performance. ([source](https://docs.bazzite.gg/General/issues_and_resolutions/))
- [Handheld Hardware Overclocking](https://awesome-repositories.com/f/operating-systems-systems-programming/handheld-hardware-overclocking.md) — Adjusts display refresh rates and applies low-risk undervolting to compatible handheld devices. ([source](https://github.com/ublue-os/bazzite/blob/main/README-FR.md))
- [Display Calibrations](https://awesome-repositories.com/f/operating-systems-systems-programming/handheld-hardware-support/display-calibrations.md) — Applies calibration profiles and supports variable refresh rates and fractional scaling for handheld screens. ([source](https://github.com/ublue-os/bazzite/blob/main/README-RU.md))
- [Hardware Feature Orchestration](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-feature-orchestration.md) — Sets up virtualization, manages GPU switching, and enables automatic disk unlocking via TPM. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/ujust/))
- [Kernel Argument Management](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-configurations/kernel-argument-management.md) — Configures module options via kernel arguments to maintain update speeds without regenerating the initramfs. ([source](https://docs.bazzite.gg/Advanced/dracut-and-initramfs/))
- [Sandbox Resource Management](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/process-and-memory-management/process-isolation/sandbox-resource-management.md) — Allows modification of security sandbox settings to control application access to system resources. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Flatpak/))
- [Layered Package Overlays](https://awesome-repositories.com/f/operating-systems-systems-programming/layered-package-overlays.md) — Allows specific binaries to be installed on top of the immutable base image for system-level integration.
- [Layered Package Reset](https://awesome-repositories.com/f/operating-systems-systems-programming/layered-package-overlays/layered-package-reset.md) — Removes manually installed host packages to restore the system to its original base image state. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/rpm-ostree/))
- [Custom Image Builders](https://awesome-repositories.com/f/operating-systems-systems-programming/os-development-distributions/custom-image-builders.md) — Provides environments for creating personalized OS installation images via automated pipelines. ([source](https://github.com/ublue-os/bazzite/blob/main/README-ID.md))
- [Battery Power Optimization](https://awesome-repositories.com/f/operating-systems-systems-programming/power-management/battery-power-optimization.md) — Adjusts CPU boost and power settings via a background daemon to extend handheld battery life. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/ASUS_ROG_Ally/))
- [Prefix-Based Package Management](https://awesome-repositories.com/f/operating-systems-systems-programming/prefix-based-package-management.md) — Manages terminal applications via a prefix-based package manager to avoid modifying the system root. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Homebrew/))
- [Single User Mode Booting](https://awesome-repositories.com/f/operating-systems-systems-programming/single-user-mode-booting.md) — Provides a minimal boot state for emergency system repairs and OS recovery when normal booting fails. ([source](https://docs.bazzite.gg/Advanced/rescue-and-emergency-mode/))

### Business & Productivity Software

- [Cross-Platform Execution](https://awesome-repositories.com/f/business-productivity-software/gaming-platforms/cross-platform-execution.md) — Executes Windows-based games using compatibility layers to ensure high-performance runtime on Linux. ([source](https://docs.bazzite.gg/))
- [Automatic Software Updates](https://awesome-repositories.com/f/business-productivity-software/automatic-software-updates.md) — Updates the operating system and applications automatically to ensure the latest versions remain installed. ([source](https://github.com/ublue-os/bazzite/blob/main/README-RU.md))

### Data & Databases

- [Deployment Rollbacks](https://awesome-repositories.com/f/data-databases/model-state-restoration/deployment-rollbacks.md) — Allows reverting the operating system to a previous stable deployment to recover from regressions. ([source](http://docs.bazzite.gg/))
- [Storage Deduplication](https://awesome-repositories.com/f/data-databases/block-storage/storage-deduplication.md) — Uses a filesystem with deduplication and compression to manage internal drives and SD cards. ([source](https://docs.bazzite.gg/General/SteamOS_Comparison/))

### Development Tools & Productivity

- [Gaming Hardware Optimizers](https://awesome-repositories.com/f/development-tools-productivity/gaming-utilities/performance-optimization-tools/game-performance-optimizers/gaming-hardware-optimizers.md) — Optimizes system performance by implementing specialized kernel parameters and I/O schedulers to eliminate stutter. ([source](https://docs.bazzite.gg/Gaming/))
- [Linux Compatibility Optimizations](https://awesome-repositories.com/f/development-tools-productivity/gaming-utilities/performance-optimization-tools/game-performance-optimizers/linux-compatibility-optimizations.md) — Optimizes Windows game performance on Linux through compatibility layers, GPU drivers, and kernel tweaks.
- [Image Layering](https://awesome-repositories.com/f/development-tools-productivity/software-package-repositories/system-package-managers/image-layering.md) — Installs packages directly into the system image for software requiring system-level integration. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/software-intro/))
- [Container Desktop Managers](https://awesome-repositories.com/f/development-tools-productivity/container-desktop-managers.md) — Provides a dedicated graphical user interface for creating and managing distribution containers. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Distrobox/))
- [Containerized Development Workflows](https://awesome-repositories.com/f/development-tools-productivity/containerized-development-workflows.md) — Provides isolated container environments for running software and development tools to keep the host system clean.
- [Storage Reclamation Utilities](https://awesome-repositories.com/f/development-tools-productivity/disk-space-management/storage-reclamation-utilities.md) — Includes utilities to identify and remove unused images, volumes, and packages to reclaim disk space. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/ujust/))
- [Flatpak Packages](https://awesome-repositories.com/f/development-tools-productivity/flatpak-packages.md) — Provides a graphical storefront for discovering and installing sandboxed Flatpak applications. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Flatpak/))
- [Hardware Daemons](https://awesome-repositories.com/f/development-tools-productivity/hardware-daemons.md) — Controls device-specific hardware via a background service to activate functional handheld features. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/Other_Handhelds/))

### DevOps & Infrastructure

- [Image Integrity Verification](https://awesome-repositories.com/f/devops-infrastructure/container-images/image-integrity-verification.md) — Checks the digital signature of the system image to ensure software has not been tampered with. ([source](https://github.com/ublue-os/bazzite/blob/main/README-SPA.md))
- [Container Isolation Technologies](https://awesome-repositories.com/f/devops-infrastructure/container-isolation-technologies.md) — Utilizes container isolation to run third-party software without modifying the immutable root filesystem. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/))
- [Containerized Application Management](https://awesome-repositories.com/f/devops-infrastructure/containerized-application-management.md) — Offers integrated configuration utilities to manage the lifecycle of containerized applications and workflows. ([source](https://github.com/ublue-os/bazzite/blob/main/README-SPA.md))
- [System Image Rollbacks](https://awesome-repositories.com/f/devops-infrastructure/deployment-rollbacks/system-image-rollbacks.md) — Updates the operating system with the ability to roll back to previous deployments. ([source](https://docs.bazzite.gg/))
- [OS Image Construction Pipelines](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-pipelines/os-image-construction-pipelines.md) — Generates personalized system versions through automated CI/CD workflows using templates and custom manifests.
- [Container Lifecycle Managers](https://awesome-repositories.com/f/devops-infrastructure/container-lifecycle-managers.md) — Uses systemd declarative unit files to automate the lifecycle and execution of containerized applications. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Quadlet/))
- [Containerized Service Deployment](https://awesome-repositories.com/f/devops-infrastructure/containerized-service-deployment.md) — Configures containerized applications to function as background system services via declarative files. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/software-intro/))
- [Deployment State Pinning](https://awesome-repositories.com/f/devops-infrastructure/deployment-rollback-systems/deployment-state-pinning.md) — Allows marking a specific system state as permanent to ensure a known-working backup is always available. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rolling_back_system_updates/))
- [Gaming Environment Provisioning](https://awesome-repositories.com/f/devops-infrastructure/gaming-environment-provisioning.md) — Pre-installs gaming software and configures a dedicated gaming mode that starts automatically on boot. ([source](https://docs.bazzite.gg/General/Fedora_Atomic_Comparison/))
- [Multi-Distribution Container Support](https://awesome-repositories.com/f/devops-infrastructure/multi-distribution-container-support.md) — Creates isolated containers for different Linux distributions to access diverse package repositories. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Containers/))
- [Hardware Firmware Updaters](https://awesome-repositories.com/f/devops-infrastructure/update-orchestrators/hardware-firmware-updaters.md) — Automates the retrieval and application of manufacturer-signed BIOS and firmware updates for hardware stability. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/Steam_Deck/))

### Hardware & IoT

- [Hardware Management](https://awesome-repositories.com/f/hardware-iot/design-lifecycle-management/hardware-engineering-management/hardware-management.md) — Manages handheld-specific hardware including RGB lighting, battery charge limits, and UI scaling. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/GPD_Handhelds/))
- [Handheld Hardware Tuning](https://awesome-repositories.com/f/hardware-iot/handheld-hardware-tuning.md) — Implements dedicated hardware management for CPU undervolting, fan control, and display overclocking on handheld devices.

### Security & Cryptography

- [Secure Boot Key Management](https://awesome-repositories.com/f/security-cryptography/secure-boot-key-management.md) — Registers custom public keys to enable Secure Boot validation for custom images. ([source](https://github.com/ublue-os/bazzite/blob/main/README-ZH-TW.md))
- [OS Image Validation](https://awesome-repositories.com/f/security-cryptography/code-signing/container-image-signing/os-image-validation.md) — Ensures system integrity by verifying digital signatures of OS images during the secure boot process.
- [Hardware-Backed Security](https://awesome-repositories.com/f/security-cryptography/hardware-backed-security.md) — Encrypts disks and implements TPM unlocking to protect data and meet anti-cheat requirements. ([source](https://docs.bazzite.gg/General/SteamOS_Comparison/))
- [Storage Encryption](https://awesome-repositories.com/f/security-cryptography/storage-encryption.md) — Protects data at rest by encrypting the system drive using LUKS. ([source](https://docs.bazzite.gg/General/Installation_Guide/install-guide/))

### Software Engineering & Architecture

- [Container Isolation](https://awesome-repositories.com/f/software-engineering-architecture/execution-control/namespace-isolation/namespace-provisioners/container-isolation.md) — Uses kernel namespaces and containers to run third-party software in isolated environments.
- [System Performance Optimization](https://awesome-repositories.com/f/software-engineering-architecture/performance-reliability/performance-optimization/data-handling-throughput/system-performance-optimization.md) — Adjusts low-level hardware and OS settings to optimize performance and compatibility across devices. ([source](https://docs.bazzite.gg/General/SteamOS_Comparison/))

### User Interface & Experience

- [Controller-Optimized Interfaces](https://awesome-repositories.com/f/user-interface-experience/controller-optimized-interfaces.md) — Provides a minimal, controller-friendly session that prioritizes hardware resources for active gaming tasks. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Steam_Gaming_Mode/))
- [Native Controller Integrators](https://awesome-repositories.com/f/user-interface-experience/form-and-input-management/input-handling/native-input-mappers/native-controller-integrators.md) — Provides specialized input drivers, firmware updaters, and controller themes for non-standard handhelds. ([source](https://github.com/ublue-os/bazzite/blob/main/README-DE.md))
- [Desktop Environment Customizers](https://awesome-repositories.com/f/user-interface-experience/desktop-environment-customizers.md) — Offers tools to adjust the visual and behavioral settings of the user interface for specific hardware. ([source](https://docs.bazzite.gg/General/))
- [Display Scaling](https://awesome-repositories.com/f/user-interface-experience/display-scaling.md) — Adjusts user interface scaling and display settings to ensure the UI fits the specific screen dimensions of handheld devices. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/Lenovo_Legion_Go/))

### Game Development

- [Pre-Game Execution Scripts](https://awesome-repositories.com/f/game-development/game-environment-setups/pre-game-execution-scripts.md) — Runs custom scripts and environment setups automatically before a game process starts. ([source](https://docs.bazzite.gg/Advanced/scopebuddy/))

### Graphics & Multimedia

- [Frame Rate Capping](https://awesome-repositories.com/f/graphics-multimedia/frame-rate-capping.md) — Controls maximum frames per second using session-level limiters or API runtime settings to maintain consistent performance. ([source](https://docs.bazzite.gg/Gaming/launch-options-env-variables/))
- [Console Emulators](https://awesome-repositories.com/f/graphics-multimedia/legacy-media-emulators/console-emulators.md) — Installs and manages console emulation tools to enable the playback of legacy game titles. ([source](https://docs.bazzite.gg/Gaming/gaming-intro/))
- [HDR Output Support](https://awesome-repositories.com/f/graphics-multimedia/virtual-displays/hdr-output-support.md) — Enables High Dynamic Range color depth for visual output when operating in the handheld gaming interface. ([source](https://github.com/ublue-os/bazzite/blob/main/README-ZH-TW.md))

### Mobile Development

- [Android Containerization](https://awesome-repositories.com/f/mobile-development/android-applications/android-containerization.md) — Includes integrated tools to configure and reset the Android container runtime environment. ([source](https://docs.bazzite.gg/Installing_and_Managing_Software/Waydroid_Setup_Guide/))
- [Cross-Distribution Environments](https://awesome-repositories.com/f/mobile-development/build-and-tooling/development-environments/cross-distribution-environments.md) — Runs software from multiple Linux distributions in isolated containers to prevent system conflicts. ([source](https://docs.bazzite.gg/General/SteamOS_Comparison/))

### System Administration & Monitoring

- [Display Customizers](https://awesome-repositories.com/f/system-administration-monitoring/advanced-display-configuration/display-customizers.md) — Provides tools to set custom screen dimensions and refresh rates for hardware compatibility. ([source](https://docs.bazzite.gg/Advanced/custom_resolution/))
- [External Monitor Managers](https://awesome-repositories.com/f/system-administration-monitoring/external-monitor-managers.md) — Automatically configures native resolutions and refresh rates for external monitors to ensure high-quality visuals. ([source](https://docs.bazzite.gg/Handheld_and_HTPC_edition/Handheld_Wiki/Lenovo_Legion_Go/))