Updating Guide
Attention
It is required to have 3% free storage of your total drive that Bazzite is installed on to update properly.
How do updates work?¶
Bazzite updates all of the changes made specifically in Bazzite itself, updates from Fedora's base packages upstream, graphic drivers, and most user installed applications. Bazzite typically has new scheduled builds twice a week and you can see when it builds here.
Desktop Images¶
- System updates happen automatically daily on a schedule and when the hardware is not under heavy use, like playing video games.
- There is a check in-place to only update the image when your CPU, battery, and RAM usage meets certain requirements.
- Updates will be downloaded in the background and will apply on the next reboot and should contain the newest build of Bazzite.
Handheld/HTPC Images (Bazzite-Deck)¶
- Updates can be managed in Steam Gaming Mode manually by the user.
- Open: Steam Menu > Settings > System > Check for Updates > Apply
- Reboot to apply system upgrades.
- Open: Steam Menu > Settings > System > Check for Updates > Apply
- Updates upgrade system packages, Steam, containers and installed applications when available.
How do I update manually on Desktop images?¶
Note
This manual method also works in Desktop Mode on Bazzite-Deck images in Desktop Mode.
- You can force an update with the System Update tool at your own convenience.
- Reboot your device after it has finished.
- This upgrades system packages, containers, and installed applications.
Terminal command to update manually:¶
ujust update
Do I have to reboot after every system update?¶
No, but the system upgrade will not apply until the next reboot.
- Desktop images: While your device is running, newer updates will still download in the background once a day, and will be waiting to be applied until the device is rebooted.
- Handheld/HTPC images: Updates will be checked daily and can be downloaded at your leisure.
- Users will need to apply system updates manually similarly to SteamOS.
How do I view the changelog for each update?¶
Changelogs can be found on the Github repository.
How often is there a new Bazzite build?¶
Usually Bazzite is built twice a week which includes the new changes from us and from Fedora Linux. Updates may happen multiple times a day regardless due to updates from application updates, firmware upgrades, and any container environments that exist on your system.
How does updating to a new Fedora major release work?¶
Bazzite should automatically update when our new builds based on that new major release are ready, and usually aims for the around the same day when the new Fedora Linux major release is out.
Can I enable update notifications for Desktop images?¶
Yes! Open a host terminal and enter:
sudo nano /etc/ublue-update/ublue-update.toml
Change this line inside of the file:
dbus_notify = false to dbus_notify = true
Save the file as /etc/ublue-update/ublue-update.toml
Notifications for updates are now active.
How do I disable automatic updates for Desktop images?¶
Note
There is a check in-place to disable automatic updates if the metered connection setting is enabled.
Open a host terminal and enter this command:
ujust toggle-update