mirror/bazzite
1
0
Fork 0
mirror of https://github.com/ublue-os/bazzite.git synced 2025-03-01 07:13:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Fix several pages with broken headers and other fixes (#1659)

Browse Source 
* chore(docs): Add fmt command to Justfile

* chore(docs): Format markdown files

* chore(docs): Minor tweaks to Justfile

* chore(docs): Fix headers in handheld wiki

* chore(docs): Fix headers in Steam Gaming Mode page

* chore(docs): Fix headers in FAQ page

* chore(docs): Fix italic text in Installation Guide index

* chore(docs): Fix headers in Installation Guide pages

* chore(docs): Fix headers in Desktop Environment Tweaks page

* chore(docs): Fix headers in Reporting Bugs  page

* chore(docs): Remove duplicated contributing page

* chore(docs): Fix headers in Contributing to Bazzite page

* chore(docs): Combine multiple blockquotes in one in Automounting page

* chore(docs): Fix broken ordered list

* chore(docs): Remove unnecesary announcement bar

* chore(docs): Fix headers in Gaming pages

* chore(docs): Add missing headers in Framework laptops install guides

* chore(docs): Add author metadata

Adresses issue #1661 regarding lacking authors section

* chore(docs): Add authors list to pages
This commit is contained in:
Zeglius 2024-09-11 23:49:06 +02:00 committed by GitHub
parent f150e417fd
commit a6e1eec678
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
53 changed files with 1412 additions and 1088 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/Justfile
View File

@ -1,4 +1,6 @@
export PATH := justfile_directory() + "/utils:" + env("PATH")
export GITHUB_REPOSITORY := "ublue-os/bazzite"
export MKDOCS_REPO_URL := "https://github.com/" + GITHUB_REPOSITORY
MKDOCS_DIR := justfile_directory()
_default:
@ -14,3 +16,7 @@ mkdocs +ARGS="":
mkdocs_clean:
rm -rf {{ MKDOCS_DIR }}/.cache
# Format all markdown files with prettier
fmt:
prettier --check --write $(find src -type f -name '*.md')

2
docs/mkdocs.yml
View File

@ -149,4 +149,4 @@ nav:
- Advanced:
- "Reset Forgotten User Password": Advanced/Reset_Forgotten_User_Password.md
- "Creating A Custom Bazzite Image": Advanced/creating_custom_image.md
- "Contributing to Bazzite": General/Contributing_to_Bazzite.md
- "Contributing to Bazzite": Advanced/Contributing_to_bazzite.md

29
docs/src/Advanced/Auto-Mounting_Secondary_Drives.md
View File

@ -1,16 +1,21 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=970", "fetched_at": "2024-09-03 16:43:14.005694+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# WARNING!
> # WARNING!
>
> **Attention**: You may lose data on the drive(s) or result in an unbootable system if configured improperly.
>
> **Note:** MicroSD cards automatically mount without any manual intervention required on Bazzite.
>
> **Important**: Do **not** use the NTFS, exFAT, or FAT32 filesystems for game library storage.
Follow this guide **at your own discretion** and make sure to read the entire document relevant to your method, so you do not miss anything!
>
> Follow this guide **at your own discretion** and make sure to read the entire document relevant to your method, so you do not miss anything!
<hr>
@ -19,25 +24,26 @@ Follow this guide **at your own discretion** and make sure to read the entire do
> **Warning**: This will wipe all existing data on it
## Note when formatting in **KDE Partition Manager**
Make sure you set permissions to **everyone**.
Use a disk graphical user interface like KDE Plasma or GNOME Disks to format your drive. We recommend formatting secondary drives to **BTRFS** or **Ext4**. BTRFS is our recommended filesystem, but Ext4 may be better for older spinning mechanical HDDs as secondary drives.
## Creating a secondary drive directory and where to mount drives?
> **Note**: Drive directories should be **lowercase** with **no spaces** for best practice.
> **Attention**: `/var/mnt` should NOT be the path, but create a new **directory** in either `/var/mnt` or `/var/run/media/`.
- `/var/mnt/...` for **permanent** drives
- `/var/run/media/...` for **removable** drives
You can make a directory in `/var/mnt/` by opening a host terminal and **entering this command in a host terminal**:
```command
cd /var/mnt
```
```command
sudo mkdir /var/mnt/games
```
@ -47,6 +53,7 @@ The drive will now be mounted in a directory known as `games`.
> **Note**: `games` can be named anything you desire that fits best practices.
### Permissions for the drive
```command
sudo chown $USER:$USER /var/mnt/games
```
@ -57,9 +64,8 @@ sudo chown $USER:$USER /var/mnt/games
> **Warning**: Do not set up auto-mount, unmount then format a drive! It can confuse the software you are configuring drives with. Instead, **remove the auto-mount first before formatting the drive**.
* [**KDE Partition Manager**](./KDE_Partition_Manager_Auto_Mount_Guide.md)
* [**GNOME Disks**](./GNOME_Disks_Auto-Mount_Guide.md)
- [**KDE Partition Manager**](./KDE_Partition_Manager_Auto_Mount_Guide.md)
- [**GNOME Disks**](./GNOME_Disks_Auto-Mount_Guide.md)
# Alternative Methods (CLI)
@ -69,7 +75,6 @@ There are also two command-line interface (CLI) methods.
2. Editing the `/etc/fstab` file
Command Line Interface methods are intended for advanced users, and it is recommended to research one of the two methods outside of this documentation.
<hr>

18
docs/src/Advanced/Contributing_to_bazzite.md
View File

@ -1,10 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=38", "fetched_at": "2024-09-03 16:43:12.863190+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# **Preliminary Reading**:
## **Preliminary Reading**:
- [**Universal Blue Project Governance**](https://universal-blue.discourse.group/docs?topic=51)
@ -12,13 +15,14 @@
<hr>
# Overview
## Overview
Bazzite is an image from [Universal Blue](https://universal-blue.org/) and you should follow Universal Blue's [contribution guidelines](https://universal-blue.org/CONTRIBUTING) before proceeding. Also read our [documentation guidelines](https://universal-blue.discourse.group/docs?topic=890) if contributing to documentation.
Check out the Bazzite's [issue tracker](https://github.com/ublue-os/bazzite/issues) to see what issues users are currently experiencing. Also check out the current [roadmap](https://github.com/orgs/ublue-os/projects/1/views/1) for Universal Blue. There is also a [forum](https://universal-blue.discourse.group/c/contributing/7) for general Universal Blue contributions.
# Contributing to Bazzite
## Contributing to Bazzite
- Adding features or fixing bugs by submitting a [pull request](https://github.com/ublue-os/bazzite/pulls).
- Reporting issues you experience on our [issue tracker](https://github.com/ublue-os/bazzite/issues).
- Adding and contributing to [documentation](https://docs.bazzite.gg).
@ -27,7 +31,7 @@ Check out the Bazzite's [issue tracker](https://github.com/ublue-os/bazzite/issu
- Troubleshooting issues with handheld hardware is appreciated.
- Reporting issues with [HHD](https://github.com/hhd-dev/hhd) directly is also helpful on handhelds.
# Building Your Own Bazzite for Testing
## Building Your Own Bazzite for Testing
> **[Bazzite Template](https://github.com/ublue-os/image-template)**
@ -37,7 +41,7 @@ If you feel comfortable with bash scripting, programming, working with container
Building your own Bazzite will give you a sandbox to play in with your own personal changes to it. Also, this can be your own version of Bazzite to daily drive. This is useful to receive the same updates upstream, but with your spin on it with differences that we cannot or will not include regarding specific packages, drivers, etc.
## Alternative Method
### Alternative Method
Using the unaffiliated [BlueBuild](https://blue-build.org/learn/universal-blue/) project to build your own Bazzite.

14
docs/src/Advanced/GNOME_Disks_Auto-Mount_Guide.md
View File

@ -1,9 +1,14 @@
# GNOME Disks Auto-Mount Guide
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=3781", "fetched_at": "2024-09-03 16:43:10.816923+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# GNOME Disks Auto-Mount Guide
![GNOME|120x120, 50%](../img/GNOME_Disks_icon.png)
**This comes pre-installed on GNOME images.**
@ -23,9 +28,11 @@
9. `auto`
10. Select "Take Ownership"
11. Open the terminal to test the mounts by running the **command**:
```command
sudo systemctl daemon-reload && sudo mount -a
```
12. **If no errors appeared then it should be safe to reboot.**
> **Note**: If errors occur, then research the error and undo what you did and try again. Redo the previous two steps in the terminal as GNOME Disks might not give a good error to search for if the test mount fails.
@ -41,22 +48,27 @@ Display Name should be added too. Name it whatever you want it to be identified
![GNOME_Mount_Options|549x500, 75%](../img/GNOME_Mount_Options.png)
### **BTRFS**:
```command
defaults,compress-force=zstd:3,noatime,lazytime,commit=120,space_cache=v2,nofail
```
### **Ext4**:
```command
defaults,noatime,errors=remount-ro,nofail,rw,users,exec
```
### **NTFS**:
```command
defaults,noatime,nofail,rw,users,exec
```
> **Note**: Do not use the NTFS filesystem for game library storage in Bazzite, and it is not supported and you will get lots of issues with it. NTFS is **not** intended as a game drive for Bazzite.
## Permissions for the drive
```command
sudo chown $USER:$USER /mnt/games
```

17
docs/src/Advanced/KDE_Partition_Manager_Auto_Mount_Guide.md
View File

@ -1,9 +1,14 @@
# KDE Partition Manager Auto-Mount Guide
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=3780", "fetched_at": "2024-09-03 16:43:09.824214+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# KDE Partition Manager Auto-Mount Guide
![KDE|48x48](../img/KDE_Partition_Manager_icon.png)
**This is pre-installed on KDE images.**
@ -24,9 +29,11 @@
9. A message will appear that the actions will edit `/etc/fstab` (Click "OK" to continue)
10. Mount the disk manually in KDE Partition Manager and enter your sudo password
11. Open the terminal to test the mounts by running the **command**:
```command
sudo systemctl daemon-reload && sudo mount -a
```
12. **If no errors appeared then it should be safe to reboot.**
> **Note**: If errors occur, then research the error and undo what you did and try again. Redo the previous two steps in the terminal (see CLI method down below and research how to use fstab) as KDE Partition Manager might not give a good error to search for if the test mount fails.
@ -34,6 +41,7 @@ sudo systemctl daemon-reload && sudo mount -a
Display Name should be added too. Name it whatever you want it to be identified as.
## Required additional options depending on **filesystem**
Use the below generic options depending on your filesystem (these are just good defaults)
You can copy+paste these into the "More.." dialog and they will be valid
@ -44,26 +52,31 @@ You can copy+paste these into the "More.." dialog and they will be valid
> **Warning**: If a drive is formatted, then do not remove it from `/etc/fstab`, so the "nofail" option is a must to avoid issues with booting.
![btrfs example|290x317](../img/btrfs_example.png)
> **Example: btrfs requires these additional options.**
### **BTRFS**:
```command
defaults,compress-force=zstd:3,noatime,lazytime,commit=120,space_cache=v2,nofail
```
### **Ext4**:
```command
defaults,noatime,errors=remount-ro,nofail,rw,users,exec
```
### **NTFS**:
```command
defaults,noatime,nofail,rw,users,exec
```
> **Note**: Do not use the NTFS filesystem for game library storage in Bazzite, and it is not supported and you will get lots of issues with it. NTFS is **not** intended as a game drive for Bazzite.
## Advanced Options (Not required for most setups)
> Change at your own risk!
### Information about compression:

15
docs/src/Advanced/Reset_Forgotten_User_Password.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=161", "fetched_at": "2024-09-03 16:43:11.636024+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -19,23 +24,33 @@ Boot with `init=/bin/bash` on the kernel command line (e.g. edit GRUB prompt.)
Continue boot process with <kbd>Ctrl</kbd>+<kbd>X</kbd>
Once you are in the GRUB command line:
1. Temporarily mount SELinux
```
mount -t selinuxfs selinuxfs /sys/fs/selinux
```
2. Load SELinux policy
```
/sbin/load_policy
```
3. Enter your new password (i.e. passwd nick)
```
passwd [INSERT USERNAME HERE]
```
4. Sync
```command
sync
```
5. Reboot
```
/sbin/reboot -ff
```

6
docs/src/Advanced/creating_custom_image.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@castrojo"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=43", "fetched_at": "2024-09-03 16:43:11.309087+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -8,7 +13,6 @@ Sometimes you don't want to make a whole new image from scratch, you just want t
**Use the official [template image](https://github.com/ublue-os/image-template) to build off of to make your own custom Bazzite.**
# Use Cases
- You want to help development by being able to test your contributions prior to submiting to the community.

30
docs/src/Gaming/Common_gaming_issues.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2658", "fetched_at": "2024-09-03 16:43:04.885968+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Steam Logs
## Steam Logs
If you encounter issues with a game launching on Steam:
@ -13,20 +18,21 @@ If you encounter issues with a game launching on Steam:
A log file should appear in your Home directory named after the game's application ID number.
# Native Linux Port Versus Windows Version
## Native Linux Port Versus Windows Version
Some Linux ports may have missing functionality or worse performance than on the Windows version running through Proton. However, there are scenarios where using the native port exclusively is your only option, and may even be desirable.
# Valve/Source Engine Games Problems
## Valve/Source Engine Games Problems
> **Note**: This only applies to specific games running on the [Source engine](https://www.pcgamingwiki.com/wiki/Engine:Source).
## Audio & Custom Content Bugs
### Audio & Custom Content Bugs
>**Attention**: Do **not** attempt to follow this workaround until you run into issues with audio or the specific scenario mentioned below regarding *Left 4 Dead 2*.
> **Attention**: Do **not** attempt to follow this workaround until you run into issues with audio or the specific scenario mentioned below regarding _Left 4 Dead 2_.
Missing voice lines or custom content not loading in Source games? SELinux is blocking MP3 decoding and other middleware because it [executes heap memory](https://github.com/ValveSoftware/steam-for-linux/issues/43).
This has also been confirmed to cause issues joining and hosting custom maps in *Left 4 Dead 2*.
This has also been confirmed to cause issues joining and hosting custom maps in _Left 4 Dead 2_.
> **Note**: Configuring SELinux is intended for advanced users and if used irresponsibly can break other components in your system and weaken the security of your device.
@ -37,6 +43,7 @@ Open a host terminal and **enter these 4 commands**:
```command
sudo su
```
```command
cd /tmp
```
@ -48,19 +55,20 @@ ausearch -c 'hl2_linux' --raw | audit2allow -M my-hl2linux
```command
semodule -X 300 -i my-hl2linux.pp
```
Reboot your device
### If you want to undo this change eventually:
#### If you want to undo this change eventually:
> Disable **or** remove the module.
#### Disable it:
##### Disable it:
```command
semodule -X 300 -d my-hl2linux
```
#### Remove and delete it:
##### Remove and delete it:
```command
semodule -X 300 -r my-hl2linux
@ -68,14 +76,16 @@ semodule -X 300 -r my-hl2linux
The `.pp` file should be in `/root` if you want to remove that.
## Source Games Not Launching
### Source Games Not Launching
If a 32-bit Source 1 engine game is not opening due to [tmalloc libraries issues](https://github.com/ValveSoftware/csgo-osx-linux/issues/3229), then open a host terminal and **enter**:
Add the following as a **launch option** to the affected game in Steam:
```command
LD_PRELOAD=/usr/lib/libtcmalloc_and_profiler.so.4 %command%
```
Delete `libtcmalloc_minimal.so.x` in the game's bin folder if present.
If this fails to fix it, then try forcing Proton Experimental in the game's properties.

50
docs/src/Gaming/Game_Launchers.md
View File

@ -1,73 +1,75 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2656", "fetched_at": "2024-09-03 16:43:09.533219+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# **Steam Setup**
## **Steam Setup**
Steam can run Windows games on Linux. It utilizes a wide range of projects and patches all packed into a piece of software built-in to Steam called [Proton](https://github.com/ValveSoftware/Proton) for Windows compatibility.
## Enabling Proton For All Steam Games
### Enabling Proton For All Steam Games
>**Note**: Skip this section if you're using a [*Handheld/HTPC*](../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) image.
* Currently Steam only allows whitelisted games to run by default on the desktop Steam client.
* You can change this by going into the Steam **Settings** > **Compatibility** > Check **Enable Steam Play for all other titles**
> **Note**: Skip this section if you're using a [_Handheld/HTPC_](../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) image.
- Currently Steam only allows whitelisted games to run by default on the desktop Steam client.
- You can change this by going into the Steam **Settings** > **Compatibility** > Check **Enable Steam Play for all other titles**
![Steam Settings|256x267, 75%](../img/Steam_Setup_Settings.png)
![Compatibility|589x499, 75%](../img/Steam_Setup_Compatibility.png)
## Forcing A Specific Proton / Steam Play Tool Version
### Forcing A Specific Proton / Steam Play Tool Version
* Games with a Linux port will be used by default on Desktop images.
* Valve selects the default runner on *Handheld/HTPC* images.
* Some games run better with a specific version of Proton or forcing the Linux runtime.
* Run that specific version by going into the game's **Properties** > **Compatibility** > **Force the use of a specific Steam Play compatibility tool**
- Games with a Linux port will be used by default on Desktop images.
- Valve selects the default runner on _Handheld/HTPC_ images.
- Some games run better with a specific version of Proton or forcing the Linux runtime.
- Run that specific version by going into the game's **Properties** > **Compatibility** > **Force the use of a specific Steam Play compatibility tool**
![Cog Icon > Properties|690x284, 75%](../img/Steam_Setup_Cog.png)
![Compatibility tab|690x492, 75%](../img/Steam_Setup_Compat_Tab.png)
# **Non-Steam Games**
## **Non-Steam Games**
* **It is recommended to use [Lutris](https://lutris.net/games?q=&ordering=-popularity&paginate_by=100) for _most_ non-steam games**.
* However, [Heroic Games Launcher](https://heroicgameslauncher.com) is intended as a suitable replacement for the Epic Games Launcher.
* [Bottles](https://usebottles.com/) is an alternative to Lutris and great for non-gaming Windows software.
* Other games and launchers are also available in the software center (_Discover_ or _GNOME Software_) like itch.io.
- **It is recommended to use [Lutris](https://lutris.net/games?q=&ordering=-popularity&paginate_by=100) for _most_ non-steam games**.
- However, [Heroic Games Launcher](https://heroicgameslauncher.com) is intended as a suitable replacement for the Epic Games Launcher.
- [Bottles](https://usebottles.com/) is an alternative to Lutris and great for non-gaming Windows software.
- Other games and launchers are also available in the software center (_Discover_ or _GNOME Software_) like itch.io.
### Lutris Setup
## Lutris Setup
![Lutris|617x500, 75%](../img/Lutris_Setup.png)
![Example of Lutris installers|623x500, 75%](../img/Lutris_Setup_Installers.png)
Lutris is game management software that doubles as a WINE front-end for Windows games. Several games and launchers can be installed by searching for the title and using one of the installer scripts for it.
### Manually adding a Windows game to Lutris
#### Manually adding a Windows game to Lutris
However if your game is not listed or doesn't work with the provided script, then manually add the executable. Add locally installed game and make sure to configure it properly within the game and runner options.
![Add Locally Installed Game|632x496, 75%](../img/Lutris_Setup_Add_Local_Game.png)
**Example 1**:
![Lutris manually adding games example 1|690x213](../img/Lutris_Setup_Add_Local_Game_1.png)
**Example 2**:
![Lutris manually adding games example 2|690x342, 100%](../img/Lutris_Setup_Add_Local_Game_2.png)
### Lutris Shortcuts
#### Lutris Shortcuts
![Lutris_Right_Click_Menu|421x447, 75%](../img/Lutris_Setup_Shortcut.png)
Right clicking a game on Lutris gives the option to add it as a non-Steam game (useful for Steam Gaming Mode), create a desktop shortcut, or an application menu shortcut.
## Gamepass / Microsoft Store Games (Cloud Streaming)
### Gamepass / Microsoft Store Games (Cloud Streaming)
Games installed from the Microsoft Store do **not** run on desktop Linux unless you use a xCloud client like [Greenlight](https://github.com/unknownskl/greenlight). Fortnite can also be played via xCloud without a Gamepass subscription using this method.
# Auto-Mounting Game Drives
## Auto-Mounting Game Drives
Read the [Auto-Mounting Secondary Drives Guide](../Advanced/Auto-Mounting_Secondary_Drives.md) for more information. It is also recommended to do your own research on drive mounting on Linux.

21
docs/src/Gaming/Hardware_compatibility_for_gaming.md
View File

@ -1,17 +1,24 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2659", "fetched_at": "2024-09-03 16:43:08.896738+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Compatible Handhelds
## Compatible Handhelds
Read the [Handheld Wiki](../Handheld_and_HTPC_edition/Handheld_Wiki/index.md) to see what handhelds Bazzite currently supports.
# Desktop/HTPC Hardware: Vulkan Compatible GPU
## Desktop/HTPC Hardware: Vulkan Compatible GPU
Linux gaming is heavily dependent on having compatible hardware with Vulkan.
If you're using a device with an older or weaker GPU that does not support **Vulkan 1.3 or later**, then you need to use older Proton and Wine builds like **Proton/WINE 6** or earlier.
Check which Vulkan version your GPU uses, enter this in the terminal:
```command
vulkaninfo | grep 'Instance Version'
```
@ -25,13 +32,13 @@ Using insufficient hardware requires utilizing older Proton versions and use thi
PROTON_USE_WINED3D=1 %command%
```
# Unsupported Filesystems for Secondary Drives
## Unsupported Filesystems for Secondary Drives
> **Warning**: You will lose all of your data reformatting secondary internal/external drives.
See also: [**Auto-Mounting Secondary Drives**](../Advanced/Auto-Mounting_Secondary_Drives.md)
## NTFS
### NTFS
If you are coming from Windows and plan to game on a secondary drive with games already installed on it, then we regret to inform you that the NTFS filesystem is **unsupported** for gaming.
@ -41,13 +48,13 @@ You can use KDE Partition Manager (KDE images) or GNOME Disks (GNOME images) to
There is a [guide](https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows) for using Proton with NTFS drive, but issues may occur with this setup.
## exFAT and FAT32
### exFAT and FAT32
exFAT and FAT32 are **unsupported** entirely. Both filesystems **do not support symbolic links** which is what Proton prefixes use.
>However, scenarios where a microSD card is formatted to exFAT *may work* in some cases, but it is entirely unsupported by Universal Blue if something goes horribly wrong using it.
> However, scenarios where a microSD card is formatted to exFAT _may work_ in some cases, but it is entirely unsupported by Universal Blue if something goes horribly wrong using it.
# Sharing Games w/ Windows Installation
## Sharing Games w/ Windows Installation
Install the unofficial [WinBtrfs](https://github.com/maharmstone/btrfs) driver on your Windows installation at your own risk. Please note that Gamepass games and games installed and launched through the Epic Games Launcher do **not** work with BTRFS under Windows.

41
docs/src/Gaming/Managing_and_modding_games.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2657", "fetched_at": "2024-09-03 16:43:07.954041+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Compatibility Layers
## Compatibility Layers
Windows games need to run through a **compatibility layer** (like Proton) on Bazzite. KDE Plasma and GNOME images pre-install different, but similar compatibility layer managers.
@ -10,56 +15,55 @@ Windows games need to run through a **compatibility layer** (like Proton) on Baz
> **GNOME Images**: [**ProtonPlus**](https://github.com/Vysp3r/protonplus)
## Using ProtonUp-Qt/ProtonPlus
### Using ProtonUp-Qt/ProtonPlus
![ProtonUp-Qt Interface|690x388](../img/ProtonUp-Qt_Interface.png)
> **KDE Plasma Images**: [**ProtonUp-Qt**](https://davidotek.github.io/protonup-qt/)
> **GNOME Images**: [**ProtonPlus**](https://github.com/Vysp3r/protonplus)
Install and update to the latest [GE-Proton](https://github.com/GloriousEggroll/proton-ge-custom), [Luxtorpeda](https://github.com/luxtorpeda-dev/luxtorpeda), and other useful [SteamPlay tools](https://steamcommunity.com/games/221410/announcements/detail/1696055855739350561).
### Steamplay Tools
#### Steamplay Tools
> View the tested games with [**GE-Proton**](https://github.com/GloriousEggroll/proton-ge-custom/blob/master/README.md#tested-games).
> View the compatible games with [**Luxtorpeda**](https://luxtorpeda-dev.github.io/packages).
## Protontricks / Winetricks
### Protontricks / Winetricks
![Protontricks|660x500](../img/Protontricks.png)
Some games require [Protontricks](https://github.com/Matoking/protontricks) (pre-installed) or [Winetricks](https://github.com/Winetricks/winetricks) (for non-Steam games, included with Lutris) to function properly.
# Hidden Files in File Manager
## Hidden Files in File Manager
Desktop Linux contains hidden files and directories that may include important files related to gaming.
**Show hidden files** by clicking the **hamburger menu** (*3 horizontal lines in the file manager*) and selecting "Show Hidden Files" to see every directory and file that is hidden by default
**Show hidden files** by clicking the **hamburger menu** (_3 horizontal lines in the file manager_) and selecting "Show Hidden Files" to see every directory and file that is hidden by default
These directories and files all start with a `.` before it
# What is a Proton/WINE Prefix?
## What is a Proton/WINE Prefix?
It's the glue that holds everything together when you run a game through Proton and also is responsible for containing any of the files the game would drop outside of the installation folder.
>*This installation folder for Steam games is usually in*:
`.../steamapps/common/<game>`
> _This installation folder for Steam games is usually in_:
> `.../steamapps/common/<game>`
## Equivalent Windows Folders
### Equivalent Windows Folders
Many PC games drop files in Windows folders like "My Documents" or "AppData" and both can be found in your prefix directory. This prefix directory may be useful for modding your games, backing up your saves, or configuration files.
![AppID|690x482, 75%](../img/Steam_AppID.png)
For games on Steam, they are located in your `~/.steam/root/steamapps/compatdata/` folder, and then the **AppID number of the game**:
- This ID by going into the game's properties on Steam in the games `Properties > Updates > App ID`
- Continue to `.../pfx/drive_c/` and wherever the game drops the file on Windows.
## Broken Proton Prefix?
### Broken Proton Prefix?
![Delete Proton Prefix|382x341, 75%](../img/Steam_Delete_Prefix.png)
@ -68,14 +72,15 @@ For games on Steam, they are located in your `~/.steam/root/steamapps/compatdata
1. Steam allows users to delete and reset their prefix only in Big Picture Mode (and Gaming Mode) by going into the game's "Developer" settings (accessed with the 'cog' / game settings icon)
2. Select **Delete Proton files**
## Non-Steam Games Prefix Management
### Non-Steam Games Prefix Management
Non-Steam games can have the prefix folder anywhere you specify:
- By default Lutris uses `~/.wine` as the main folder.
- However, sometimes it's also in `~/Games`.
- WineZGUI creates a prefix in `~/.var/app/io.github.fastrizwaan.WineZGUI/data/winezgui/Prefixes`.
# Modding Quick-Start
## Modding Quick-Start
Steam Workshop is the easiest way to obtain mods, but is not supported for every title and requires you to own the game on Steam. Some mod managers have Linux ports like [r2modman.](https://github.com/ebkr/r2modmanPlus)
@ -86,15 +91,15 @@ Replace files and directories is still supported in both the game directory and
Some mods require a "WINE DLL OVERRIDE" environment variable in the Steam launch options.
> **Example for DirectInput8 DLL Override**:
`WINEDLLOVERRIDES="dinput8=n,b" %command%`
> `WINEDLLOVERRIDES="dinput8=n,b" %command%`
# Enhancements Pre-Installed on Bazzite
## Enhancements Pre-Installed on Bazzite
- [LatencyFleX](https://github.com/ishitatsuyuki/LatencyFleX) - Vendor agnostic alternative to Nvidia Reflex
- [vkBasalt](https://github.com/DadSchoorse/vkBasalt) - Vulkan post-processing layer with ReShade FX support
- [Mangohud](https://github.com/flightlessmango/Mangohud) - Hardware and frame-rate monitoring overlay
## Configuration Templates for DXVK, MangoHud, & vkBasalt
### Configuration Templates for DXVK, MangoHud, & vkBasalt
![Template|690x334, 50%](../img/DXVK_Mango_VkBasalt_templ.png)

30
docs/src/Gaming/index.md
View File

@ -1,6 +1,9 @@
---
title: Gaming
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=31", "fetched_at": "2024-09-03 16:43:06.311188+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -9,36 +12,41 @@ title: Gaming
Linux gaming being a viable competitor to Windows is a relatively new paradigm. Most Windows exclusive games can run on Bazzite using modern hardware. There are still some rough edges, but gaming on Linux does offer advantages on the appropriate hardware such as better frame-times than on Windows.
# [Game Launchers](Game_Launchers.md)
## [Game Launchers](Game_Launchers.md)
- Setting Up Steam
- Non-Steam Games
- Available Options
- Configuring Lutris
- Gamepass Using Xbox Cloud Gaming
# [Managing & Modding Games](Managing_and_modding_games.md)
## [Managing & Modding Games](Managing_and_modding_games.md)
- Compatibility Layers
- Proton Prefix Information
- Hidden Files in File Manager
- Modding Quick-Start
- Pre-Installed Enhancements
# [Common Gaming Issues](Common_gaming_issues.md)
## [Common Gaming Issues](Common_gaming_issues.md)
- Proton Logs
- Native Linux Builds vs. Proton
- Issues with Valve/Source Games
# [Hardware Compatibility for Gaming](Hardware_compatibility_for_gaming.md)
## [Hardware Compatibility for Gaming](Hardware_compatibility_for_gaming.md)
- Compatible Handhelds
- Vulkan Capable GPU for Desktop/HTPC Hardware
- Information Regarding Unsupported Filesystems
# Useful External Resources
* [**ProtonDB**](https://www.protondb.com/explore) - User reports for game compatibility on Linux
* [**Are We Anti-Cheat Yet?**](https://areweanticheatyet.com/) - List of popular games utilizing anti-cheat software and if the game supports Linux
* [**Linux Gaming Wiki**](https://linux-gaming.kwindu.eu/index.php?title=Main_Page) - Introduction to Linux gaming that includes helpful links
* [**PC Gaming Wiki**](https://www.pcgamingwiki.com/wiki/Home) - General information, workarounds, and enhancements for PC games
* [**General Emulation Wiki**](https://emulation.gametechwiki.com/index.php/Main_Page) - Emulation resources
## Useful External Resources
- [**ProtonDB**](https://www.protondb.com/explore) - User reports for game compatibility on Linux
- [**Are We Anti-Cheat Yet?**](https://areweanticheatyet.com/) - List of popular games utilizing anti-cheat software and if the game supports Linux
- [**Linux Gaming Wiki**](https://linux-gaming.kwindu.eu/index.php?title=Main_Page) - Introduction to Linux gaming that includes helpful links
- [**PC Gaming Wiki**](https://www.pcgamingwiki.com/wiki/Home) - General information, workarounds, and enhancements for PC games
- [**General Emulation Wiki**](https://emulation.gametechwiki.com/index.php/Main_Page) - Emulation resources
<hr>

46
docs/src/General/Contributing_to_Bazzite.md
View File

@ -1,46 +0,0 @@
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=38", "fetched_at": "2024-09-03 16:43:18.600333+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# **Preliminary Reading**:
- [**Universal Blue Project Governance**](https://universal-blue.discourse.group/docs?topic=51)
- [**Contributing Guide**](https://universal-blue.discourse.group/docs?topic=81)
<hr>
# Overview
Bazzite is an image from [Universal Blue](https://universal-blue.org/) and you should follow Universal Blue's [contribution guidelines](https://universal-blue.org/CONTRIBUTING) before proceeding. Also read our [documentation guidelines](https://universal-blue.discourse.group/docs?topic=890) if contributing to documentation.
Check out the Bazzite's [issue tracker](https://github.com/ublue-os/bazzite/issues) to see what issues users are currently experiencing. Also check out the current [roadmap](https://github.com/orgs/ublue-os/projects/1/views/1) for Universal Blue. There is also a [forum](https://universal-blue.discourse.group/c/contributing/7) for general Universal Blue contributions.
# Contributing to Bazzite
- Adding features or fixing bugs by submitting a [pull request](https://github.com/ublue-os/bazzite/pulls).
- Reporting issues you experience on our [issue tracker](https://github.com/ublue-os/bazzite/issues).
- Adding and contributing to [documentation](https://docs.bazzite.gg).
- Language translations are encouraged for documentation and the [README](https://github.com/ublue-os/bazzite/blob/main/README.md).
- Testing Bazzite on unique hardware configurations.
- Troubleshooting issues with handheld hardware is appreciated.
- Reporting issues with [HHD](https://github.com/hhd-dev/hhd) directly is also helpful on handhelds.
# Building Your Own Bazzite for Testing
>**[Bazzite Template](https://github.com/ublue-os/image-template)**
Read about forking your own Bazzite image [here](https://ublue-os.github.io/bazzite/Advanced/creating_custom_image/).
If you feel comfortable with bash scripting, programming, working with containers, or anything upstream (Fedora, Flatpak, etc.) then feel free to contribute to Bazzite if you have want to add a feature or bug fix.
Building your own Bazzite will give you a sandbox to play in with your own personal changes to it. Also, this can be your own version of Bazzite to daily drive. This is useful to receive the same updates upstream, but with your spin on it with differences that we cannot or will not include regarding specific packages, drivers, etc.
## Alternative Method
Using the unaffiliated [BlueBuild](https://blue-build.org/learn/universal-blue/) project to build your own Bazzite.
<hr>
<-- [**View all Bazzite documentation**](../index.md)

41
docs/src/General/Desktop_Environment_Tweaks.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=574", "fetched_at": "2024-09-03 16:43:19.212243+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Customizing KDE Plasma
## Customizing KDE Plasma
> Resource on KDE themes can be found [here](https://itsfoss.com/properly-theme-kde-plasma/) for more information.
@ -12,7 +17,7 @@ Do **not** install themes with the built-in KDE system settings installer since
![Directory|401x207, 75%](../img/Directory.png)
## Universal instructions for most custom themes
### Universal instructions for most custom themes
Step-by-step instructions to install custom themes on KDE Plasma.
@ -20,32 +25,35 @@ Step-by-step instructions to install custom themes on KDE Plasma.
2. Extracting the contents to `~/.local/share/plasma/` (you may need to make this directory)
3. Open the system settings and select your theme, style, cursor etc. as it now should appear
### Theme Extraction Locations
#### Theme Extraction Locations
The location where specific KDE Plasma components will be extracted on the desktop.
#### Global Themes
Global themes are placed in `~/.local/share/plasma/look-and-feel/` (*you may need to make this directory*).
##### Global Themes
#### Plasma Themes
"Plasma themes" are placed in `~/.local/share/plasma/desktoptheme/` (*you may need to make this directory*).
Global themes are placed in `~/.local/share/plasma/look-and-feel/` (_you may need to make this directory_).
#### SDDM (Login Manager) Themes
SDDM themes are placed in `/etc/sddm/themes` (*you may need to make this directory*).
##### Plasma Themes
"Plasma themes" are placed in `~/.local/share/plasma/desktoptheme/` (_you may need to make this directory_).
##### SDDM (Login Manager) Themes
SDDM themes are placed in `/etc/sddm/themes` (_you may need to make this directory_).
SDDM themes can also be layered at your own risk if they are available as RPM packages.
#### Icon / Cursor Themes
##### Icon / Cursor Themes
"Icon/Cursor themes" are placed in `~/.icons`
#### Application Permissions to Use Themes
##### Application Permissions to Use Themes
Some Flatpaks need filesystem permissions for applications that have issues with cursor themes.
**Example**: (`~/.icons/:ro` in "Filesystem" in each problematic application or globally in Flatseal).
#### Themes that require `kvantum`
##### Themes that require `kvantum`
Some themes require [`kvantum`](https://github.com/tsujan/Kvantum/blob/master/Kvantum/README.md) to be installed on the host system.
@ -55,7 +63,7 @@ Install it with this **command**:
rpm-ostree install kvantum
```
## Wallpaper Engine Guide (*Only on KDE Images*)
### Wallpaper Engine Guide (_Only on KDE Images_)
> **Note**: Not all wallpapers are compatible and may even cause issues since most are not intended for use on the Linux desktop.
@ -65,18 +73,17 @@ rpm-ostree install kvantum
![Wallpaper settings|549x500, 75%](../img/Wallpaper_settings.png)
Read this [guide](https://github.com/catsout/wallpaper-engine-kde-plugin/blob/main/README.md#usage) on how to set it up on KDE Plasma.
<hr>
# Manage GNOME Extensions (`-gnome` Images)
## Manage GNOME Extensions (`-gnome` Images)
View the [Bluefin documentation](https://docs.projectbluefin.io/administration#managing-extensions) since most of the information will be relevant to Bazzite as well.
<hr>
# Steam Gaming Mode Tweaks (`-deck` Images)
## Steam Gaming Mode Tweaks (`-deck` Images)
> Decky Loader will sometimes have issues with new Steam and Gamescope updates, and may need to be uninstalled temporarily.

66
docs/src/General/FAQ.md
View File

@ -1,21 +1,28 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=33", "fetched_at": "2024-09-03 16:43:17.727110+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Why is it called Bazzite?
## Why is it called Bazzite?
[Fedora Linux's Atomic Desktops](https://fedoraproject.org/atomic-desktops/) originally followed a naming scheme based on [minerals.](https://fedoraproject.org/kinoite/) Bazzite is a mineral that is known for being strong, lightweight, and is colored [blue](https://universal-blue.org/).
# What Bazzite image do I use?
## What Bazzite image do I use?
Bazzite's [website](https://bazzite.gg/#image-picker) offers a streamlined way of selecting the correct image which will be chosen based on hardware, desktop environment, and to include Steam Gaming Mode if the hardware supports it.
Bazzite offers multiple images, but most images will be following *one of these two formats*:
Bazzite offers multiple images, but most images will be following _one of these two formats_:
- Bazzite that automatically boots into Steam Gaming Mode with manual updates
- Bazzite that does **not** have Steam Gaming Mode and receives automatic updates daily
**Images are split up between **two** types of Bazzite editions**:
## 1. Desktop Edition
### 1. Desktop Edition
> **Steam Gaming Mode is not on these specific images!**
@ -25,7 +32,7 @@ Steam and other gaming utilities are part of the base operating system. System r
The choice of KDE Plasma and GNOME for the desktop environment with others planned for the future. [Flathub](https://flathub.org/) is enabled out of the box, so all of the applications that you would find on SteamOS are available on Bazzite.
## [2. Handheld/HTPC Edition (`-deck` Images)](../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
### [2. Handheld/HTPC Edition (`-deck` Images)](../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
Mimics SteamOS with "**Steam Gaming Mode**" and its features fully functional. This version of Bazzite boots directly into the Steam Gaming Mode session and are intended for handheld PCs and home theater setups.
@ -33,17 +40,16 @@ Images also includes a Desktop Mode session with the choice of GNOME or KDE Plas
> Steam Gaming Mode **requires** a modern AMD graphics card or an Intel Arc graphics card.
### Desktop Environments & Specific Hardware Variants
#### Desktop Environments & Specific Hardware Variants
Both types of images also come with the choice of using [KDE Plasma](https://kde.org/plasma-desktop/) or [GNOME](https://www.gnome.org/) for the desktop environment and certain images are made with specific hardware support.
There is more information about this topic on the [Installation Guide](../General/Installation_Guide/index.md) to help guide users on which image to choose before the installation.
## Bazzite Image Chart
### Bazzite Image Chart
| Image | Desktop Environment | Steam Gaming Mode | Hardware | Edition |
|--- | --- | --- | --- | ---|
| --------------------------- | ------------------- | ----------------- | ---------------------------------------- | ------------- |
| `bazzite` | KDE Plasma | No | AMD/Intel GPUs | Desktop |
| `bazzite-nvidia` | KDE Plasma | No | Nvidia GPUs | Desktop |
| `bazzite-gnome` | GNOME | No | AMD/Intel GPUs | Desktop |
@ -57,14 +63,14 @@ There is more information about this topic on the [Installation Guide](../Genera
| `bazzite-ally` | KDE Plasma | Yes | ASUS Laptops (Steam Gaming Mode Enabled) | Handheld/HTPC |
| `bazzite-ally-gnome` | GNOME | Yes | ASUS Laptops (Steam Gaming Mode Enabled) | Handheld/HTPC |
### Who are the target audiences?
## Who are the target audiences?
- Desktop users who want an operating system designed for gaming with inspiration from SteamOS that has fairly low maintenance.
- Steam Deck users who feel limited by SteamOS and also want newer system packages.
- Home Theater PC setups for a console-like experience.
- [Handheld PC](../Handheld_and_HTPC_edition/Handheld_Wiki/index.md) users who would prefer a SteamOS-like experience.
# SteamOS is based on Arch Linux, so why use Fedora Linux?
## SteamOS is based on Arch Linux, so why use Fedora Linux?
SteamOS receives package and driver updates less frequently despite the rolling release base.
@ -74,7 +80,8 @@ Fedora Linux and Universal Blue currently supports a specific "atomic" implement
> The **goal** of Bazzite is to have an operating system ready to game after installing it.
### Any advantages to using Fedora?
#### Any advantages to using Fedora?
Since Bazzite is a custom Fedora Atomic Desktop image, it makes use of read-only root files for stability purposes, and is built with [libostree](https://docs.fedoraproject.org/en-US/fedora-silverblue/technical-information/) which has advantages such as:
- Low risk of an unbootable system
@ -85,7 +92,7 @@ Since Bazzite is a custom Fedora Atomic Desktop image, it makes use of read-only
> Check out the [Universal Blue homepage](https://universal-blue.org) for more information on what this project is capable of.
## How is Fedora Atomic Desktop different than Fedora Workstation?
### How is Fedora Atomic Desktop different than Fedora Workstation?
If you're familiar with [Fedora Workstation](https://www.fedoraproject.org/workstation/) and [Fedora's Spins](https://www.fedoraproject.org/spins/), but not the Fedora Atomic Desktops paradigm, the major difference is with stability between system upgrades. There are read-only root files and an emphasis on installing applications as a Flatpak or inside [containers.](https://distrobox.it/) Read more about [obtaining software on Bazzite](../Installing_and_Managing_Software/index.md).
@ -93,12 +100,13 @@ Users can rollback to a previous deployment if a system update breaks their work
Here's a helpful [cheat sheet](https://docs.fedoraproject.org/en-US/fedora-silverblue/_attachments/silverblue-cheatsheet.pdf) for using **advanced** commands, but gives a glimpse of what this paradigm is capable of. There is also a future planned ahead of this technology. Upcoming additions like [bootc](https://containers.github.io/bootc/) will be a major change when it is ready for production.
## Is this another fringe Linux distribution?
### Is this another fringe Linux distribution?
Bazzite is **not** a Linux distribution in the traditional sense. It's a custom Fedora Atomic Desktop image with a recipe on top of it. Universal Blue images are a proof of concept of using containerized workflows with transactional and in-place operating system updates, and Bazzite exists by being gaming focused with inspiration from SteamOS.
> Essentially, Bazzite is a Fedora Atomic Desktop installation, but with the aid of Universal Blue's tooling, adds packages, services, drivers, etc. to the base image of it.
### How does Bazzite differ?
#### How does Bazzite differ?
Bazzite is using a new "**container-native**" approach that Fedora has been testing, and we are taking full advantage of it.
@ -108,13 +116,13 @@ Unlike traditional Linux distributions, **most of the maintenance and security u
> The ultimate goal of Bazzite is to be Fedora Linux, but provide a great gaming experience out of the box while also being an alternative operating system for the Steam Deck.
#### Image Matrix
##### Image Matrix
We provide several different images that all get the same additions and fixes through updates at the same time unless specified otherwise. Many images are hardware specific for compatibility reasons, yet all of the images will usually receive the same features and fixes at the same time.
There can be a hypothetical scenario where everyone involved with Bazzite could stop maintaining the project at once and it will still continue to receive updates directly from upstream.
# Can this be used as a daily driver?
## Can this be used as a daily driver?
**Yes**.
@ -122,8 +130,10 @@ Updates are obtained and downloaded straight from upstream which means there is
> A friendly reminder that this project is still in its early stages and moving at a fast pace with updates and changes nearly daily.
## What are some of the utilities that Bazzite ships?
(*in alphabetical order*)
### What are some of the utilities that Bazzite ships?
(_in alphabetical order_)
- [Boxkit](https://github.com/ublue-os/boxkit): Tool used for custom OCI Distrobox/Toolbox containers, and anything from [DaVinci Resolve](https://github.com/zelikos/davincibox) to [OBS Studio Portable](https://github.com/ublue-os/obs-studio-portable) can be accessed with this. (The software is in their own special container, so dependencies do not affect your host.)
- [Discover Overlay](https://github.com/trigg/Discover): Discord chat overlay integration for Steam Gaming Mode which has a [special configuration](https://trigg.github.io/Discover/bazzite) for Bazzite where it launches automatically
- [Handheld Daemon](https://github.com/hhd-dev/hhd): Tool for configuring and managing handheld devices from gyro, LEDs, paddles, and TDP.
@ -131,10 +141,11 @@ Updates are obtained and downloaded straight from upstream which means there is
- [`ujust`](../Installing_and_Managing_Software/ujust.md): Execute custom commands based on recipes.
- [yafti (Bazzite Portal)](https://github.com/ublue-os/yafti/): First-boot utility for installing additional software.
## Can I use this desktop environment or that standalone window manager?
### Can I use this desktop environment or that standalone window manager?
Make your own [custom image based off Bazzite](https://universal-blue.discourse.group/docs?topic=43) with the DE and WM change that you want.
## Is Secure Boot supported?
### Is Secure Boot supported?
> **WARNING (Steam Deck hardware only):** The Steam Deck does not come with secure boot enabled and does not ship with any keys enrolled by default, so do not enable this on Steam Deck hardware unless you absolutely know what you're doing!
@ -142,18 +153,17 @@ Make your own [custom image based off Bazzite](https://universal-blue.discourse.
More information on enrolling the key in our [Secure Boot guide](https://universal-blue.discourse.group/docs?topic=2742).
# Are AMD, Intel, and Nvidia graphics card drivers pre-installed?
## Are AMD, Intel, and Nvidia graphics card drivers pre-installed?
Yes and they are updated during a system upgrade when available.
## What if I change hardware?
### What if I change hardware?
Most hardware changes should **not** require any manual intervention outside of the expectations from that particular hardware which would be OS-agnostic.
However, if you swap from or to a Nvidia GPU, then [rebasing](../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rebase_guide.md) will be necessary as a manual intervention to get the appropriate graphics drivers.
# What is the difference between Bluefin, Aurora, and Bazzite?
## What is the difference between Bluefin, Aurora, and Bazzite?
> **TL;DR**: Bazzite is the gaming-centric version of Bluefin (GNOME) and Aurora (KDE Plasma).
@ -161,7 +171,7 @@ However, if you swap from or to a Nvidia GPU, then [rebasing](../Installing_and_
Bazzite exclusively focuses on having an out of the box Linux gaming experience for desktop, HTPC hardware, and handhelds. Bazzite can be summed up as Bluefin and Aurora but tuned for PC gaming. All 3 are community-centric custom Fedora Atomic Desktop that is configured for their specific target audience, and for Bazzite specifically: PC gamers who want to use the Linux desktop as the alternative to Windows.
# How do I change the hostname of my device?
## How do I change the hostname of my device?
Edit the `/etc/hostname` file with a new hostname, save it, and reboot.
@ -169,11 +179,11 @@ Edit the `/etc/hostname` file with a new hostname, save it, and reboot.
hostnamectl hostname <hostname>
```
# Questions Regarding Java
## Questions Regarding Java
If its for Minecraft, then install the [Prism Launcher](https://flathub.org/apps/org.prismlauncher.PrismLauncher) for mods that require anything Java related. If its for development use [Distrobox](../Installing_and_Managing_Software/Distrobox.md). You will not be able to change Java on your host.
# Why are builds failing?
## Why are builds failing?
![Builds Failing|178x43](../img/Builds_Failing.png)

35
docs/src/General/Installation_Guide/Installing_Bazzite_Framework_Laptop_13.md
View File

@ -1,25 +1,34 @@
---
authors:
- Matt_Hartley
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1818", "fetched_at": "2024-09-03 16:43:26.585334+00:00"}-->
<!-- ANCHOR_END: METADATA -->
1. Download the Framework Laptop image of [Bazzite](https://bazzite.gg/). Make sure you select Intel or AMD depending on the mainboard in your device:
## 1. Download the image
Download the Framework Laptop image of [Bazzite](https://bazzite.gg/). Make sure you select Intel or AMD depending on the mainboard in your device:
![1|690x426](../../img/Framework_bazzite.jpeg)
1. **Create a USB stick** using [Fedora Media Writer](https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_on_windows) ([Windows](https://fedoraproject.org/fmw/FedoraMediaWriter-win32-latest.exe) or [Mac](https://fedoraproject.org/fmw/FedoraMediaWriter-osx-latest.dmg) or [Linux](https://flathub.org/apps/org.fedoraproject.MediaWriter))
## 2. Create a USB bootable stick
* Insert your USB drive (8GB or larger). Note that it will be reformatted, so make sure you are ok with erasing any data that is on it.
* After installing Fedora Media Writer, run it. Choose Select .iso file, browse to bazzite-gnome-stable.iso (GNOME) or bazzite-stable.iso (KDE) and select it.
* Click the Write button.
* Once the USB drive creation is complete, you can click Finish, close Fedora Media Writer, eject your USB drive.
**Create a USB stick** using [Fedora Media Writer](https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_on_windows) ([Windows](https://fedoraproject.org/fmw/FedoraMediaWriter-win32-latest.exe) or [Mac](https://fedoraproject.org/fmw/FedoraMediaWriter-osx-latest.dmg) or [Linux](https://flathub.org/apps/org.fedoraproject.MediaWriter))
3. **Booting to the Bazzite USB**
- Insert your USB drive (8GB or larger). Note that it will be reformatted, so make sure you are ok with erasing any data that is on it.
- After installing Fedora Media Writer, run it. Choose Select .iso file, browse to bazzite-gnome-stable.iso (GNOME) or bazzite-stable.iso (KDE) and select it.
- Click the Write button.
- Once the USB drive creation is complete, you can click Finish, close Fedora Media Writer, eject your USB drive.
* Insert the USB drive into your powered off Framework Laptop 13, and then power on. If you have an existing OS installed on the Storage drive in your laptop, immediately after the power light comes on begin rapidly tapping (continuously ) the F12 key - you must begin tapping well before you see the Framework logo.
* Select Linpus lite (General UDisk) with your arrow keys. Enter key.
* Next select Install Bazzite. Hit the enter key.
* Select the keyboard language you’d like to use. On the next screen, click on the Installation Destination button to choose the disk.
* If there is an OS already installed on the target drive, you’ll need to follow the guided steps to delete the existing partitions.
* Click Finish Installation and then reboot into your new Bazzite install!
## 3. Booting to the Bazzite USB
- Insert the USB drive into your powered off Framework Laptop 13, and then power on. If you have an existing OS installed on the Storage drive in your laptop, immediately after the power light comes on begin rapidly tapping (continuously ) the F12 key - you must begin tapping well before you see the Framework logo.
- Select Linpus lite (General UDisk) with your arrow keys. Enter key.
- Next select Install Bazzite. Hit the enter key.
- Select the keyboard language you’d like to use. On the next screen, click on the Installation Destination button to choose the disk.
- If there is an OS already installed on the target drive, you’ll need to follow the guided steps to delete the existing partitions.
- Click Finish Installation and then reboot into your new Bazzite install!
![boot1|592x444](../../img/Installing_Framework_1.jpeg)

72
docs/src/General/Installation_Guide/Installing_Bazzite_for_Desktop_or_Laptop_Hardware.md
View File

@ -1,15 +1,20 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1146", "fetched_at": "2024-09-03 16:43:27.199924+00:00"}-->
<!-- ANCHOR_END: METADATA -->
![Desktop|690x448](../../img/Desktop.jpeg)
# Pre-Installation
## Pre-Installation
> Pre-requisites and steps before installing Bazzite.
## Minimum System Requirements
### Minimum System Requirements
- **Architecture**: x86_64
- **Firmware**: UEFI (CSM Support should be **disabled** if available)
- **Processor (CPU)** : 2GHz quad core processor or better
@ -19,15 +24,16 @@
- **Network**: Stable internet connection with no bandwidth caps
- **Additional Notes**: Certain [drivers](https://github.com/morrownr/8812au-20210820) are **not** compatible with Bazzite.
### Installer Requirements
* A USB flash drive with 10GB free space
* **Note**: All data on this drive will be wiped when flashed
* Software to flash the image:
* [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
* Make sure to properly eject the drive after flashing the ISO to it
* Physical keyboard
#### Installer Requirements
## Desktop Environments
- A USB flash drive with 10GB free space
- **Note**: All data on this drive will be wiped when flashed
- Software to flash the image:
- [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
- Make sure to properly eject the drive after flashing the ISO to it
- Physical keyboard
### Desktop Environments
Bazzite comes with the choice of [KDE Plasma](https://kde.org/plasma-desktop/) or [GNOME](https://www.gnome.org/) for the desktop environment.
@ -35,7 +41,7 @@ Bazzite comes with the choice of [KDE Plasma](https://kde.org/plasma-desktop/) o
More information can be found on our [FAQ](https://faq.bazzite.gg) about the differences between the image variants.
### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
#### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
![KDE Plasma|690x388, 75%](../../img/KDE_Plasma_DE.jpeg)
@ -44,7 +50,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Qt framework
- Popular Linux distributions like SteamOS use KDE Plasma
### [GNOME (`-gnome` images)](https://www.gnome.org/)
#### [GNOME (`-gnome` images)](https://www.gnome.org/)
![GNOME|690x359, 75%](../../img/GNOME_DE.png)
@ -53,8 +59,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- GTK framework
- Popular Linux distributions like Ubuntu use GNOME
### [Steam Gaming Mode (`-deck` images)](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
#### [Steam Gaming Mode (`-deck` images)](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
![Gaming Mode|690x388, 75%](../../img/Gaming_Mode.jpeg)
@ -67,26 +72,26 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Choice of KDE Plasma or GNOME in Desktop Mode
- Extra functionality with [Decky](https://github.com/SteamDeckHomebrew/decky-loader) [plugins](https://plugins.deckbrew.xyz/)
## Dual Boot Preliminary Setup + Post-Setup Guide
### Dual Boot Preliminary Setup + Post-Setup Guide
Read the [Dual Boot Guide](./dual_boot_setup_guide.md) **after** reading this guide before proceeding.
# Installation Guide
## Installation Guide
> The part of the guide that requires the most effort.
## 1. Download and Flash Bazzite
### 1. Download and Flash Bazzite
- Download [Bazzite](https://download.bazzite.gg) after choosing the correct ISO for your hardware with our Image Picker tool.
- Flash Bazzite to your bootable medium.
- Eject drive.
### Current Fedora Atomic Desktop Users
#### Current Fedora Atomic Desktop Users
Current [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/) users can rebase with the terminal command listed on the website under the "**Existing Fedora Atomic Desktop Users**" section and can skip the next step.
## 2. Boot Bazzite
### 2. Boot Bazzite
- Connect your bootable medium to your device and boot into it.
- After connecting the device, boot into the Bazzite installer.
- This depends on your motherboard hardware, but most of the time it could be a function keys like <kbd>F9</kbd> or similar.
@ -94,7 +99,7 @@ Current [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/) user
- Alternatively change the BIOS settings to boot with your bootable device first before your current storage, but this is **not recommended** to keep enabled after installing Bazzite.
- Verify the media correctly and proceed to the installer.
## 3. Installer
### 3. Installer
![Installer](../../img/anaconda_installer.png)
@ -113,34 +118,35 @@ Current [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/) user
- Begin the installation.
- Reboot device after it has finished installing.
### Important information for users with Secure Boot **enabled**:
#### Important information for users with Secure Boot **enabled**:
Read the [Secure Boot Guide](https://universal-blue.discourse.group/docs?topic=2742) for more information.
<hr>
# Post-Installation
## Post-Installation
> The fine tuning before gaming.
## GRUB Menu
### GRUB Menu
![Rollbacks|690x402, 50%](../../img/GRUB_Menu.png)
The first boot will show a screen showing your current and last deployment. It will automatically boot if nothing. It is important to note that the GRUB menu can be used to rollback Bazzite deployments if you encounter issues.
Read more about this in the [Updates, Rollback, and Rebasing documentation](../../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/index.md).
## Configuring System Settings for KDE Plasma and GNOME
### Configuring System Settings for KDE Plasma and GNOME
![Display Settings (KDE Plasma)|690x370, 75%](../../img/KDE_Display_Settings.png)
***KDE Plasma's System Settings application***
**_KDE Plasma's System Settings application_**
![Display Settings (GNOME)|690x344, 75%](../../img/GNOME_Display_Settings.png)
***GNOME's Settings application***
**_GNOME's Settings application_**
It is important to configure the system settings on a first boot to personalize your desktop especially if you notice the scaling is incorrect on first-boot.
## First Boot Setup Utility: Bazzite Portal
### First Boot Setup Utility: Bazzite Portal
![Welcome to Bazzite|618x500, 75%](../../img/yafti_welcome.jpeg)
@ -159,11 +165,11 @@ An application will pop up welcoming you to Bazzite when you boot into the deskt
> **Attention**: There is a rare chance you will be asked to setup KDE Wallet or GNOME Keyring and set a password to continue installing items from the Bazzite Portal.
## Installing additional software
### Installing additional software
The [Installing and Managing Applications documentation](../../Installing_and_Managing_Software/index.md) is useful to learn how to install additional software on Bazzite outside of the Bazzite Portal.
# Ready to Game
## Ready to Game
**You have now installed Bazzite!**
@ -173,13 +179,13 @@ Check out the additional [documentation](https://docs.bazzite.gg) surrounding th
<hr>
# **Video Tutorial - Dual Boot Setup w/ Secure Boot Enabled**:
## **Video Tutorial - Dual Boot Setup w/ Secure Boot Enabled**:
https://www.youtube.com/watch?v=dXBN9OM7mSE
<hr>
# Issues Installing Bazzite?
## Issues Installing Bazzite?
View the [Installation Troubleshoot Guide](./troubleshoot_guide.md).

47
docs/src/General/Installation_Guide/Installing_Bazzite_for_Framework_Laptop_16.md
View File

@ -1,38 +1,47 @@
---
authors:
- Matt_Hartley
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1819", "fetched_at": "2024-09-03 16:43:25.971719+00:00"}-->
<!-- ANCHOR_END: METADATA -->
1. Download the Framework Laptop image of [Bazzite](https://bazzite.gg/). Make sure you select Intel or AMD depending on the mainboard in your device:
## 1. Download the image
Download the Framework Laptop image of [Bazzite](https://bazzite.gg/). Make sure you select Intel or AMD depending on the mainboard in your device:
![1](../../img/Framework_bazzite.jpeg)
2. **Create a USB stick** using [Fedora Media Writer](https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_on_windows) ([Windows](https://fedoraproject.org/fmw/FedoraMediaWriter-win32-latest.exe) or [Mac](https://fedoraproject.org/fmw/FedoraMediaWriter-osx-latest.dmg) or [Linux](https://flathub.org/apps/org.fedoraproject.MediaWriter))
## 2. Create a USB bootable stick
* Insert your USB drive (8GB or larger). Note that it will be reformatted, so make sure you are ok with erasing any data that is on it.
* After installing Fedora Media Writer, run it. Choose Select .iso file, browse to bazzite-gnome-stable.iso (GNOME) or bazzite-stable.iso (KDE) and select it.
* Click the Write button.
* Once the USB drive creation is complete, you can click Finish, close Fedora Media Writer, eject your USB drive.
**Create a USB stick** using [Fedora Media Writer](https://docs.fedoraproject.org/en-US/fedora/latest/preparing-boot-media/#_on_windows) ([Windows](https://fedoraproject.org/fmw/FedoraMediaWriter-win32-latest.exe) or [Mac](https://fedoraproject.org/fmw/FedoraMediaWriter-osx-latest.dmg) or [Linux](https://flathub.org/apps/org.fedoraproject.MediaWriter))
3. **Linux Audio Compatibility**
- Insert your USB drive (8GB or larger). Note that it will be reformatted, so make sure you are ok with erasing any data that is on it.
- After installing Fedora Media Writer, run it. Choose Select .iso file, browse to bazzite-gnome-stable.iso (GNOME) or bazzite-stable.iso (KDE) and select it.
- Click the Write button.
- Once the USB drive creation is complete, you can click Finish, close Fedora Media Writer, eject your USB drive.
* Before we begin the installation process with the Live USB, let’s make sure you have your Linux Audio Compatibility set to Linux in the BIOS.
* Power on the laptop, repeatedly tapping F2 in order to get into the BIOS. Note: If you’re having trouble with this, try again, holding down the Fn key while rapidly tapping F2.
* In BIOS mode, arrow key over to Setup Utility. Press the enter key. Arrow down to Advanced. Then arrow right, then arrow down to Linux Audio Compatibility. Press enter.
* A new box for Linux Audio Compatibility will appear, arrow to Linux, then press enter. Now press F10 key to reboot.
* Now we don’t have an OS installed yet. So the reboot won’t get us to a running operating system and we fully expect to see an error to this point. Simply press the power button to shutdown.
## 3. Linux Audio Compatibility
- Before we begin the installation process with the Live USB, let’s make sure you have your Linux Audio Compatibility set to Linux in the BIOS.
- Power on the laptop, repeatedly tapping F2 in order to get into the BIOS. Note: If you’re having trouble with this, try again, holding down the Fn key while rapidly tapping F2.
- In BIOS mode, arrow key over to Setup Utility. Press the enter key. Arrow down to Advanced. Then arrow right, then arrow down to Linux Audio Compatibility. Press enter.
- A new box for Linux Audio Compatibility will appear, arrow to Linux, then press enter. Now press F10 key to reboot.
- Now we don’t have an OS installed yet. So the reboot won’t get us to a running operating system and we fully expect to see an error to this point. Simply press the power button to shutdown.
![audio1|592x444](../../img/Install_Framework_16_audio_1.jpeg)
![audio2|592x444](../../img/Install_Framework_16_audio_2.jpeg)
4. **Booting to the Bazzite USB**
## 4. Booting to the Bazzite USB
* Insert the USB drive into your powered off Framework Laptop 13, and then power on. If you have an existing OS installed on the Storage drive in your laptop, immediately after the power light comes on begin rapidly tapping (continuously ) the F12 key - you must begin tapping well before you see the Framework logo.
* Select Linpus lite (General UDisk) with your arrow keys. Enter key.
* Next select Install Bazzite. Hit the enter key.
* Select the keyboard language you’d like to use. On the next screen, click on the Installation Destination button to choose the disk.
* If there is an OS already installed on the target drive, you’ll need to follow the guided steps to delete the existing partitions.
* Click Finish Installation and then reboot into your new Bazzite install!
- Insert the USB drive into your powered off Framework Laptop 13, and then power on. If you have an existing OS installed on the Storage drive in your laptop, immediately after the power light comes on begin rapidly tapping (continuously ) the F12 key - you must begin tapping well before you see the Framework logo.
- Select Linpus lite (General UDisk) with your arrow keys. Enter key.
- Next select Install Bazzite. Hit the enter key.
- Select the keyboard language you’d like to use. On the next screen, click on the Installation Destination button to choose the disk.
- If there is an OS already installed on the target drive, you’ll need to follow the guided steps to delete the existing partitions.
- Click Finish Installation and then reboot into your new Bazzite install!
![boot1|592x444](../../img/Installing_Framework_1.jpeg)

74
docs/src/General/Installation_Guide/Installing_Bazzite_for_HTPC_Setups.md
View File

@ -1,14 +1,20 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1145", "fetched_at": "2024-09-03 16:43:24.537747+00:00"}-->
<!-- ANCHOR_END: METADATA -->
![HTPC|609x371](../../img/HTPC.png)
# Pre-Installation
## Pre-Installation
> Pre-requisites and steps before installing Bazzite.
## Minimum System Requirements
### Minimum System Requirements
- **Architecture**: x86_64
- **Firmware**: UEFI (CSM Support should be **disabled** if available)
- **Processor (CPU)** : 2GHz quad core processor or better
@ -18,21 +24,23 @@
- **Network**: Stable internet connection with no bandwidth caps
- **Additional Notes**: Certain [drivers](https://github.com/morrownr/8812au-20210820) are **not** compatible with Bazzite.
### Steam Gaming Mode Requirements
#### Steam Gaming Mode Requirements
- A modern AMD GPU
- Intel Arc GPUs may work with **major caveats**
- Nvidia GPUs are **not** supported
- [Steam](https://store.steampowered.com/) account
### Installer Requirements
* A USB flash drive with 10GB free space
* **Note**: All data on this drive will be wiped when flashed
* Software to flash the image:
* [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
* Make sure to properly eject the drive after flashing the ISO to it
* Physical keyboard
#### Installer Requirements
## Desktop Environments
- A USB flash drive with 10GB free space
- **Note**: All data on this drive will be wiped when flashed
- Software to flash the image:
- [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
- Make sure to properly eject the drive after flashing the ISO to it
- Physical keyboard
### Desktop Environments
All of the images come with the choice of [KDE Plasma](https://kde.org/plasma-desktop/) or [GNOME](https://www.gnome.org/) for their desktop environment.
@ -40,7 +48,7 @@ All of the images come with the choice of [KDE Plasma](https://kde.org/plasma-de
More information can be found on our [FAQ](https://faq.bazzite.gg) about the differences between the image variants.
### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
#### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
![KDE Plasma|690x388, 75%](../../img/KDE_Plasma_DE.jpeg)
@ -49,7 +57,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Qt framework
- Popular Linux distributions like SteamOS use KDE Plasma
### [GNOME (`-gnome` images)](https://www.gnome.org/)
#### [GNOME (`-gnome` images)](https://www.gnome.org/)
![GNOME|690x359, 75%](../../img/GNOME_DE.png)
@ -58,8 +66,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- GTK framework
- Popular Linux distributions like Ubuntu use GNOME
### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
#### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
![Gaming Mode|690x388, 75%](../../img/Gaming_Mode.jpeg)
@ -72,22 +79,22 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Choice of KDE Plasma or GNOME in Desktop Mode
- Extra functionality with [Decky](https://github.com/SteamDeckHomebrew/decky-loader) [plugins](https://plugins.deckbrew.xyz/)
# Installation Guide
## Installation Guide
> The part of the guide that requires the most effort.
## 1. Download and Flash Bazzite
### 1. Download and Flash Bazzite
- Download [Bazzite](https://download.bazzite.gg) after choosing the correct ISO for your hardware with our Image Picker tool.
- Flash Bazzite to your bootable medium.
- Eject drive.
### Current Fedora Atomic Desktop Users
#### Current Fedora Atomic Desktop Users
Current [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/) users can rebase with the terminal command listed on the website under the "Existing Fedora Atomic Desktop Users" section and can skip the next step.
## 2. Boot Bazzite
### 2. Boot Bazzite
- Connect your bootable medium to your device and boot into it.
- After connecting the device, boot into the Bazzite installer.
- This depends on your motherboard hardware, but most of the time it could be a function keys like <kbd>F9</kbd> or similar.
@ -95,11 +102,11 @@ Current [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/) user
- Alternatively change the BIOS settings to boot with your bootable device first before your current storage, but this is **not recommended** to keep enabled after installing Bazzite.
- Verify the media correctly and proceed to the installer.
## Dual Boot Preliminary Setup + Post-Setup Guide
### Dual Boot Preliminary Setup + Post-Setup Guide
Read the [Dual Boot Guide](https://universal-blue.discourse.group/docs?topic=2743) **after** reading this guide before proceeding.
## 3. Installer
### 3. Installer
![Installer](../../img/anaconda_installer.png)
@ -118,34 +125,35 @@ Read the [Dual Boot Guide](https://universal-blue.discourse.group/docs?topic=274
- Begin the installation.
- Reboot device after it has finished installing.
### Important information for users with Secure Boot **enabled**:
#### Important information for users with Secure Boot **enabled**:
Read the [Secure Boot Guide](https://universal-blue.discourse.group/docs?topic=2742) for more information.
<hr>
# Post-Installation
## Post-Installation
> The fine tuning before gaming.
## GRUB Menu
### GRUB Menu
![Rollbacks|690x402, 50%](../../img/GRUB_Menu.png)
The first boot will show a screen showing your current and last deployment. It will automatically boot if nothing. It is important to note that the GRUB menu can be used to rollback Bazzite deployments if you encounter issues.
Read more about this in the [Updates, Rollback, and Rebasing documentation](../../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/index.md).
## Configuring System Settings for KDE Plasma and GNOME
### Configuring System Settings for KDE Plasma and GNOME
![Display Settings (KDE Plasma)|690x370, 75%](../../img/KDE_Display_Settings.png)
***KDE Plasma's System Settings application***
**_KDE Plasma's System Settings application_**
![Display Settings (GNOME)|690x344, 75%](../../img/GNOME_Display_Settings.png)
***GNOME's Settings application***
**_GNOME's Settings application_**
It is important to configure the system settings on a first boot to personalize your desktop especially if you notice the scaling is incorrect on first-boot.
## First Boot Setup Utility: Bazzite Portal
### First Boot Setup Utility: Bazzite Portal
![Welcome to Bazzite|618x500, 75%](../../img/yafti_welcome.jpeg)
@ -164,15 +172,15 @@ An application will pop up welcoming you to Bazzite when you boot into the deskt
> **Attention**: There is a rare chance you will be asked to setup KDE Wallet or GNOME Keyring and set a password to continue installing items from the Bazzite Portal.
## Installing additional software
### Installing additional software
The [Installing and Managing Applications documentation](../../Installing_and_Managing_Software/index.md) is useful to learn how to install additional software on Bazzite outside of the Bazzite Portal.
## Login to Steam & Reboot Device
### Login to Steam & Reboot Device
Login to Steam then **reboot** your device when you finish setting up your device during the first-boot process.
### Setup Steam Gaming Mode
#### Setup Steam Gaming Mode
![Steam Gaming Mode Setup|690x442, 50%](../../img/pLvHB1NAMlb3ghsR72q7l9Auj8B.jpeg)
@ -182,7 +190,7 @@ After completing all of the above, then your next boot will be in Steam Gaming M
<hr>
# Issues Installing Bazzite?
## Issues Installing Bazzite?
View the [Installation Troubleshoot Guide](./troubleshoot_guide.md).

87
docs/src/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs.md
View File

@ -1,47 +1,53 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1144", "fetched_at": "2024-09-03 16:43:22.899176+00:00"}-->
<!-- ANCHOR_END: METADATA -->
![ASUS ROG Ally|690x301](../../img/ASUS_ROG_Ally.jpeg)
# Important Notes on Handheld Hardware
## Important Notes on Handheld Hardware
> **Note**: Bazzite requires a stable internet connection with no bandwidth cap in place.
> **Attention**: Several handhelds require BitLocker to be unlocked (write down your recovery key too), Windows "Fast Startup" disabled, and **not** putting Windows into Hibernation Mode before installing Bazzite.
> [Bazzite's Handheld Wiki](https://universal-blue.discourse.group/docs?topic=1038) contains information on setting up your handheld after installing Bazzite and workarounds for known issues.
<hr>
# Pre-Installation
## Pre-Installation
> Pre-requisites and steps before installing Bazzite.
### Installer Requirements
* A USB flash drive with 10GB free space
* **Note**: All data on this drive will be wiped when flashed
* Software to flash the image:
* [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
* Make sure to properly eject the drive after flashing the ISO to it
* Optional: Physical keyboard (without one, your username will be `bazzite` and the password will be `bazzite`)
#### Installer Requirements
### Steam Gaming Mode Requirements
* Compatible graphics card
* A **modern AMD GPU**
* An **Intel Arc GPU** (Other Intel GPU series will not boot Steam Gaming Mode)
* Intel Arc handhelds will currently have missing functionality (TDP limit, controls, etc.)
- A USB flash drive with 10GB free space
- **Note**: All data on this drive will be wiped when flashed
- Software to flash the image:
- [Fedora Media Writer](https://www.fedoraproject.org/en/workstation/download/), [Ventoy](https://www.ventoy.net/en/index.html), or [Rufus](https://rufus.ie/en/)
- Make sure to properly eject the drive after flashing the ISO to it
- Optional: Physical keyboard (without one, your username will be `bazzite` and the password will be `bazzite`)
#### Steam Gaming Mode Requirements
- Compatible graphics card
- A **modern AMD GPU**
- An **Intel Arc GPU** (Other Intel GPU series will not boot Steam Gaming Mode)
- Intel Arc handhelds will currently have missing functionality (TDP limit, controls, etc.)
Handheld users will also benefit from also reading the [Steam Gaming Mode documentation][Steam_Gaming_Mode].
## Desktop Environments
### Desktop Environments
All of the images come with the choice of [KDE Plasma](https://kde.org/plasma-desktop/) or [GNOME](https://www.gnome.org/) for their desktop environment.
More information can be found on our [FAQ](https://faq.bazzite.gg) about the differences between the image variants.
### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
#### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
![KDE Plasma|690x388, 75%](../../img/KDE_Plasma_DE.jpeg)
@ -50,7 +56,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Qt framework
- Popular Linux distributions like SteamOS use KDE Plasma
### [GNOME (`-gnome` images)](https://www.gnome.org/)
#### [GNOME (`-gnome` images)](https://www.gnome.org/)
![GNOME|690x359, 75%](../../img/GNOME_DE.png)
@ -59,8 +65,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- GTK framework
- Popular Linux distributions like Ubuntu use GNOME
### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
#### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
![Gaming Mode|690x388, 75%](../../img/Gaming_Mode.jpeg)
@ -73,33 +78,31 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Choice of KDE Plasma or GNOME in Desktop Mode
- Extra functionality with [Decky](https://github.com/SteamDeckHomebrew/decky-loader) [plugins](https://plugins.deckbrew.xyz/)
## Dual Boot Preliminary Setup + Post-Setup Guide
### Dual Boot Preliminary Setup + Post-Setup Guide
Read the [Dual Boot Guide](https://universal-blue.discourse.group/docs?topic=2743) **after** reading this guide first before proceeding.
<hr>
# Installation Guide
## Installation Guide
> The part of the guide that requires the most effort.
## 1. Download and Flash Bazzite
### 1. Download and Flash Bazzite
- Download [Bazzite](https://download.bazzite.gg) after choosing the correct handheld hardware with our Image Picker tool.
- Flash Bazzite to your bootable medium.
- Eject drive.
## 2. Boot Installation Medium
### 2. Boot Installation Medium
You may need to research your handheld on how to boot from removable storage. It may be similar to the Steam Deck with holding down one of the "volume buttons" and pressing another button, but like for other general hardware, it highly dependent on your hardware.
## 3. Installer Setup
### 3. Installer Setup
> **NOTE**: If you do not have a usb physical keyboard connected, do **NOT** press “*User Creation*”, since it will remove the default username and password, and you will be unable to type a username or password without a physical keyboard.
> **NOTE**: If you do not have a usb physical keyboard connected, do **NOT** press “_User Creation_”, since it will remove the default username and password, and you will be unable to type a username or password without a physical keyboard.
> **default user**: `bazzite`
> **default password**: `bazzite`
> **default user**: `bazzite` > **default password**: `bazzite`
![Installer|690x348](../../img/uHKqd8F4nxZryfP8ebBz1DIbNVv.png)
@ -123,34 +126,35 @@ You may need to research your handheld on how to boot from removable storage. I
- Begin the installation.
- Reboot device after it has finished installing.
### Important information for users with Secure Boot **enabled**:
#### Important information for users with Secure Boot **enabled**:
Read the [Secure Boot Guide](https://universal-blue.discourse.group/docs?topic=2742).
<hr>
# Post-Installation
## Post-Installation
> The fine tuning before gaming.
## GRUB Menu
### GRUB Menu
![Rollbacks|690x402, 50%](../../img/GRUB_Menu.png)
The first boot will show a screen showing your current and last deployment. It will automatically boot if nothing. It is important to note that the GRUB menu can be used to rollback Bazzite deployments if you encounter issues.
Read more about this in the [Updates, Rollback, and Rebasing documentation](../../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/index.md).
## Configuring System Settings for KDE Plasma and GNOME
### Configuring System Settings for KDE Plasma and GNOME
![Display Settings (KDE Plasma)|690x370, 75%](../../img/KDE_Display_Settings.png)
***KDE Plasma's System Settings application***
**_KDE Plasma's System Settings application_**
![Display Settings (GNOME)|690x344, 75%](../../img/GNOME_Display_Settings.png)
***GNOME's Settings application***
**_GNOME's Settings application_**
After you have booted into the Desktop for the first-time configuration, then you can should adjust the settings to your liking. The most important setting that may need to be changed is the scaling setting in "Display(s) [and Monitor]" since it can be incorrect for the screen of your hardware on a fresh installation. Monitor orientation should also be corrected if it is rotated improperly.
## First Boot Setup Utility: Bazzite Portal
### First Boot Setup Utility: Bazzite Portal
![Welcome to Bazzite|618x500, 75%](../../img/yafti_welcome.jpeg)
@ -169,12 +173,11 @@ An application will pop up welcoming you to Bazzite when you boot into the deskt
> **Attention**: There is a rare chance you will be asked to setup KDE Wallet or GNOME Keyring and set a password to continue installing items from the Bazzite Portal.
## Installing additional software
### Installing additional software
The [Installing and Managing Applications documentation](../../Installing_and_Managing_Software/index.md) is useful to learn how to install additional software on Bazzite outside of the Bazzite Portal.
## Login to Steam & Reboot Device
### Login to Steam & Reboot Device
Login to Steam then **reboot** your device when you finish setting up your device during the first-boot process.
@ -182,13 +185,13 @@ Login to Steam then **reboot** your device when you finish setting up your devic
After completing all of the above, then your next boot will be in Steam Gaming Mode which requires additional setup for Steam.
### Post-Setup and Known Issues for Handhelds and Steam Gaming Mode
#### Post-Setup and Known Issues for Handhelds and Steam Gaming Mode
Read the [Handheld Wiki](https://universal-blue.discourse.group/docs?topic=1038) and [Steam Gaming Mode Overview documentation][Steam_Gaming_Mode] for information regarding Bazzite on handheld PCs.
<hr>
# **Video Tutorial**
## **Video Tutorial**
> **Note**: We strongly recommend **manual partitioning + creating a separate EFI partition** for dual-booting, **not** automatic partitioning.
>
@ -198,7 +201,7 @@ https://www.youtube.com/watch?v=H4226yq0ZwY
<hr>
# Issues Installing Bazzite?
## Issues Installing Bazzite?
View the [Installation Troubleshoot Guide](./troubleshoot_guide.md).

67
docs/src/General/Installation_Guide/Installing_Bazzite_for_Steam_Deck.md
View File

@ -1,14 +1,19 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1143", "fetched_at": "2024-09-03 16:43:25.151999+00:00"}-->
<!-- ANCHOR_END: METADATA -->
![image|690x332](../../img/image.jpeg)
# Bazzite on the Steam Deck
## Bazzite on the Steam Deck
> **Attention**: XHCI has to be set as the USB Mode for the Steam Deck for our ISO to boot! If it is set to DRD, please change it in your BIOS settings, and more information can be found [here](https://github.com/ublue-os/bazzite/issues/808#issuecomment-1963141866).
## Status
### Status
Bazzite functions properly on the Steam Deck LCD (256GB+) and Steam Deck OLED models.
@ -17,23 +22,22 @@ Read the [Handheld Wiki entry for the Steam Deck](https://universal-blue.discour
> **Note**: Bazzite requires a stable internet connection with no bandwidth cap in place.
<hr>
# Pre-Installation
## Pre-Installation
> Pre-requisites and steps before installing Bazzite.
### Installer Requirements
* A USB flash drive with 10GB free space
* **Note**: All data on this drive will be wiped when flashed
* Software to flash the image:
* [Ventoy](https://www.ventoy.net/en/index.html)
* Make sure to properly eject the drive after flashing the ISO to it
* Optional: Physical keyboard (without one, your username will be `bazzite` and the password will be `bazzite`)
#### Installer Requirements
- A USB flash drive with 10GB free space
- **Note**: All data on this drive will be wiped when flashed
- Software to flash the image:
- [Ventoy](https://www.ventoy.net/en/index.html)
- Make sure to properly eject the drive after flashing the ISO to it
- Optional: Physical keyboard (without one, your username will be `bazzite` and the password will be `bazzite`)
## Desktop Environments
### Desktop Environments
All of the images come with the choice of [KDE Plasma](https://kde.org/plasma-desktop/) or [GNOME](https://www.gnome.org/) for their desktop environment.
@ -41,7 +45,7 @@ All of the images come with the choice of [KDE Plasma](https://kde.org/plasma-de
More information can be found on our [FAQ](https://faq.bazzite.gg) about the differences between the image variants.
### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
#### [KDE Plasma (Default)](https://kde.org/plasma-desktop/)
![KDE Plasma|690x388, 75%](../../img/KDE_Plasma_DE.jpeg)
@ -50,7 +54,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- Qt framework
- Popular Linux distributions like SteamOS use KDE Plasma
### [GNOME (`-gnome` images)](https://www.gnome.org/)
#### [GNOME (`-gnome` images)](https://www.gnome.org/)
![GNOME|690x359, 75%](../../img/GNOME_DE.png)
@ -59,8 +63,7 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
- GTK framework
- Popular Linux distributions like Ubuntu use GNOME
### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
#### [Steam Gaming Mode (`-deck` images)][Steam_Gaming_Mode]
![Gaming Mode|690x388, 75%](../../img/Gaming_Mode.jpeg)
@ -77,19 +80,19 @@ More information can be found on our [FAQ](https://faq.bazzite.gg) about the dif
<hr>
# Installation Guide
## Installation Guide
> The part of the guide that requires the most effort.
**IMPORTANT**: XHCI has to be set as the USB Mode for the Steam Deck for our ISO to boot! If it is set to DRD, please change it in your BIOS settings. More information can be found [here](https://github.com/ublue-os/bazzite/issues/808#issuecomment-1963141866).
## 1. Download and Flash Bazzite
### 1. Download and Flash Bazzite
- Download [Bazzite](https://download.bazzite.gg) after choosing the Steam Deck ISO with our Image Picker tool.
- Flash Bazzite to your bootable medium.
- Eject drive.
## 2. Boot Installation Medium
### 2. Boot Installation Medium
Hold the 'Volume Down' (<kbd>-</kbd>) button and click the Power Button, and when you hear the chime, let go of both buttons, and you'll be booted into the Boot Manager.
@ -99,12 +102,11 @@ When you get to the boot menu, select your bootable device to boot into the Bazz
Access this with the "**Troubleshooting**" section when the ISO is booted.
## 3. Installer
### 3. Installer
> **NOTE**: If you do not have a usb physical keyboard connected, do **NOT** press "*User Creation*", since it will remove the default username and password, and you will be unable to type a username or password without a physical keyboard.
> **NOTE**: If you do not have a usb physical keyboard connected, do **NOT** press "_User Creation_", since it will remove the default username and password, and you will be unable to type a username or password without a physical keyboard.
>**default user**: `bazzite`
>**default password**: `bazzite`
> **default user**: `bazzite` >**default password**: `bazzite`
![Installer|690x348](../../img/uHKqd8F4nxZryfP8ebBz1DIbNVv.png)
@ -125,11 +127,12 @@ Access this with the "**Troubleshooting**" section when the ISO is booted.
- Begin the installation.
- Reboot device after it has finished installing.
# Post-Installation
## Post-Installation
> The fine tuning before gaming.
## GRUB Menu
### GRUB Menu
![Rollbacks|690x402, 50%](../../img/GRUB_Menu.png)
The first boot will show a screen showing your current and last deployment. It will automatically boot if nothing. It is important to note that the GRUB menu can be used to rollback Bazzite deployments if you encounter issues.
@ -137,14 +140,14 @@ The first boot will show a screen showing your current and last deployment. It w
Read more about this in the [Updates, Rollback, and Rebasing documentation](../../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/index.md).
![Display Settings (KDE Plasma)|690x370, 75%](../../img/KDE_Display_Settings.png)
***KDE Plasma's System Settings application***
**_KDE Plasma's System Settings application_**
![Display Settings (GNOME)|690x344, 75%](../../img/GNOME_Display_Settings.png)
***GNOME's Settings application***
**_GNOME's Settings application_**
It is important to configure the system settings on a first boot to personalize your desktop especially if you notice the scaling is incorrect on first-boot.
## First Boot Setup Utility: Bazzite Portal
### First Boot Setup Utility: Bazzite Portal
![Welcome to Bazzite|618x500, 75%](../../img/yafti_welcome.jpeg)
@ -163,15 +166,15 @@ An application will pop up welcoming you to Bazzite when you boot into the deskt
> **Attention**: There is a rare chance you will be asked to setup KDE Wallet or GNOME Keyring and set a password to continue installing items from the Bazzite Portal.
## Installing additional software
### Installing additional software
The [Installing and Managing Applications documentation](../../Installing_and_Managing_Software/index.md) is useful to learn how to install additional software on Bazzite outside of the Bazzite Portal.
## Login to Steam & Reboot Device
### Login to Steam & Reboot Device
Login to Steam then **reboot** your device when you finish setting up your device during the first-boot process.
### Setting Up Steam Gaming Mode
#### Setting Up Steam Gaming Mode
![Gaming Mode Setup|690x442, 50%](../../img/pLvHB1NAMlb3ghsR72q7l9Auj8B.jpeg)
@ -181,7 +184,7 @@ After completing all of the above, then your next boot will be in Steam Gaming M
<hr>
# Issues Installing Bazzite?
## Issues Installing Bazzite?
View the [Installation Troubleshoot Guide](./troubleshoot_guide.md).

32
docs/src/General/Installation_Guide/dual_boot_setup_guide.md
View File

@ -1,15 +1,20 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "htthttps://universal-blue.discourse.group/docs?topic=2743", "fetched_at": "2024-09-03 16:43:23.309649+00:00"}-->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2743", "fetched_at": "2024-09-03 16:43:23.309649+00:00"}-->
<!-- ANCHOR_END: METADATA -->
> **Note**: Make sure to read the [**Installation Guide**](./index.md) for your device first before proceeding.
# Two Methods: Method *A* or Method *B*
## Two Methods: Method _A_ or Method _B_
* **A)** Installing Bazzite on a separate drive (Recommended)
* **B)** Manual partitioning on the same drive
- **A)** Installing Bazzite on a separate drive (Recommended)
- **B)** Manual partitioning on the same drive
## **A**) *Separate* Drive Method
### **A**) _Separate_ Drive Method
> **Note**: This method is ideal for desktops and HTPCs, and would be inconvenient for handhelds unless planned to keep stationary.
@ -21,7 +26,7 @@ Install Bazzite on a separate internal or external drive.
You can also install Windows to an external drive with Windows-to-Go using [Rufus](https://rufus.ie/en/) to dual boot if you do not have an internal drive available.
## **B**) *Same* Drive Method
### **B**) _Same_ Drive Method
> **Note**: This must be done **before installing Bazzite**.
@ -29,23 +34,25 @@ You can also install Windows to an external drive with Windows-to-Go using [Rufu
If you do not have multiple drives or are using a device that will not be stationary, then you will have to manually partition on the same drive.
### Note about dual booting with **Windows** specifically:
#### Note about dual booting with **Windows** specifically:
Dual booting Bazzite with Windows on the same drive works better with **Windows already installed before Bazzite**.
### Bazzite Partition
#### Bazzite Partition
Create space for Bazzite with the Disk Management application in Windows.
<kbd>Win</kbd> + <kbd>R</kbd> to open Windows Run and enter:
```
diskmgmt.msc
```
Then, right-click your Windows partition and select "Shrink Volume" from the drop-down menu. Afterwards, select how much storage you want to allocate for Bazzite.
It is **strongly recommended for to setup a separate EFI partition**. The separate EFI partition will help prevent Windows Updates from affecting your Bazzite installation later down the line.
# Manual Partitioning to the Same Drive for Dual Boot Setups
## Manual Partitioning to the Same Drive for Dual Boot Setups
If you need a tutorial video for manual partitioning, watch this [tutorial](https://www.youtube.com/watch?v=EDip92Zq-RE).
@ -82,18 +89,19 @@ If you need a tutorial video for manual partitioning, watch this [tutorial]( htt
<hr>
# Dual Boot Post-Configuration Setup
## Dual Boot Post-Configuration Setup
> **Note:** [Handheld/HTPC](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) images hide GRUB by default, but the <kbd>Esc</kbd> key on a keyboard will unhide the GRUB menu without unhiding it with a `ujust` command.
## Regenerate GRUB to show Windows Entry
### Regenerate GRUB to show Windows Entry
If you do **not** see your Windows boot in the GRUB menu, then open a host terminal and **enter**:
```
ujust regenerate-grub
```
## Bazzite as Primary Boot
### Bazzite as Primary Boot
If the `OS Boot Manager` has set `Windows Boot Manager` to be the first boot priority, then this may result in booting directly into Windows after the install instead of Bazzite. You may have to fix this in your BIOS settings.

22
docs/src/General/Installation_Guide/index.md
View File

@ -1,36 +1,40 @@
---
title: Installation Guide
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=30", "fetched_at": "2024-09-03 16:43:25.704918+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# **Important Installation Notes**:
* Use a download manager if the direct download fails or is downloading too slow.
- Use a download manager if the direct download fails or is downloading too slow.
* A physical wired keyboard is **recommended**.
- A physical wired keyboard is **recommended**.
* Create a User Account with a **username** and a **user password** if you have a keyboard.
- Create a User Account with a **username** and a **user password** if you have a keyboard.
* Make sure to only select the appropriate drives to avoid losing data on others, and it is best practice to safely remove any external drives before proceeding.
- Make sure to only select the appropriate drives to avoid losing data on others, and it is best practice to safely remove any external drives before proceeding.
* Secure Boot is supported on most hardware, but you must [**enroll our key**](./secure_boot.md).
- Secure Boot is supported on most hardware, but you must [**enroll our key**](./secure_boot.md).
# Choose Your Hardware:
- [Installing Bazzite for **Desktop/Laptop Hardware**](./Installing_Bazzite_for_Desktop_or_Laptop_Hardware.md)
- [Installing Bazzite for **Framework Laptop 16**](./Installing_Bazzite_for_Framework_Laptop_16.md)
- [Installing Bazzite for **Framework Laptop 13 (AMD/Intel GPU)**](./Installing_Bazzite_Framework_Laptop_13.md)
- [Installing Bazzite for **Home Theater PC (HTPC) Setups**](./Installing_Bazzite_for_HTPC_Setups.md)*
- [Installing Bazzite for **Home Theater PC (HTPC) Setups**](./Installing_Bazzite_for_HTPC_Setups.md)\*
- [Installing Bazzite on the **Steam Deck**](./Installing_Bazzite_for_Steam_Deck.md)*
- [Installing Bazzite on the **Steam Deck**](./Installing_Bazzite_for_Steam_Deck.md)\*
- [Installing Bazzite on **Handheld PCs**](./Installing_Bazzite_for_Handheld_PCs.md)*
- [Installing Bazzite on **Handheld PCs**](./Installing_Bazzite_for_Handheld_PCs.md)\*
**Indicates that [**Steam Gaming Mode**](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) is intended for this device and ships with the ISO.*
\*_Indicates that [**Steam Gaming Mode**](../../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md) is intended for this device and ships with the ISO._
# Issues Installing Bazzite?

17
docs/src/General/Installation_Guide/secure_boot.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2742", "fetched_at": "2024-09-03 16:43:23.922705+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Secure Boot Information
## Secure Boot Information
![Secure Boot|690x378, 50%](../../img/Secure_Boot.jpeg)
@ -12,32 +17,36 @@
> **Warning**: The Steam Deck does **not** come with secure boot enabled and does not ship with any keys enrolled by default, do not enable Secure Boot on your Steam Deck unless you absolutely know what you're doing.
## Error message if key is **not** enrolled properly:
### Error message if key is **not** enrolled properly:
![load the kernel first error|613x63](../../img/load_the_kernel_first_error.jpeg)
Follow **Method B** below to resolve this and move past the error message if you encounter it.
# **Method A**) During Installation Method (See Image Above)
## **Method A**) During Installation Method (See Image Above)
A blue screen will appear giving the option to enroll the signed keys after leaving the Bazzite installer.
`Enroll MOK` if you have secure boot enabled. If prompted to enter a password, then **enter**:
```command
universalblue
```
Otherwise `Continue boot` if you have Secure Boot disabled or if it is not supported with your hardware.
# **Method B**) After Installation Method
## **Method B**) After Installation Method
> **ATTENTION**: Disable Secure Boot before doing this, and then re-enable it after enrolling the key.
If you have already installed Bazzite then **enter this command in a host terminal**:
```
ujust enroll-secure-boot-key
```
If prompted to enroll the required key, then **enter the password in the host terminal**:
```command
universalblue
```

23
docs/src/General/Installation_Guide/troubleshoot_guide.md
View File

@ -1,22 +1,26 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2495", "fetched_at": "2024-09-03 16:43:22.238775+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# ISO Workarounds
## ISO Workarounds
A generic error may appear during installation.
**Workaround Video Tutorial**:
https://www.youtube.com/watch?v=GRdz08hJByo
# Alternative Installation Methods
## Alternative Installation Methods
> **Attention**: Both workaround methods may have scaling issues with the installer depending on the hardware especially if it is a handheld PC.
> **Note**: The workarounds below are also useful for **downloading a smaller ISO size**.
### **Option 1**: Rebasing from a Fedora Atomic Desktop Image (Recommended)
#### **Option 1**: Rebasing from a Fedora Atomic Desktop Image (Recommended)
If you experience issues with installing our ISO or the bootable drive you have is too small for Bazzite, then download the [Fedora Kinoite (**KDE Plasma**)](https://fedoraproject.org/atomic-desktops/kinoite/) or [Fedora Silverblue (**GNOME**)](https://fedoraproject.org/atomic-desktops/silverblue/) depending on which desktop environment preferred.
@ -33,9 +37,11 @@ If you experience issues with installing our ISO or the bootable drive you have
```command
ujust _install-system-flatpaks
```
> Choose the "Flathub" remote.
>
> **This command installs:**
>
> - [Flatpak applications for **KDE Plasma** images](https://github.com/ublue-os/bazzite/blob/9f6f5e143b7545d06803e70e7723997400bd8b88/system_files/desktop/kinoite/usr/share/ublue-os/bazzite/flatpak/install)
> - [Flatpak applications for **GNOME** images](https://github.com/ublue-os/bazzite/blob/9f6f5e143b7545d06803e70e7723997400bd8b88/system_files/desktop/silverblue/usr/share/ublue-os/bazzite/flatpak/install)
@ -44,14 +50,14 @@ ujust _install-system-flatpaks
```command
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/<IMAGE>
```
Replace `<IMAGE>` with the image you're using which can be found from the "**Existing Fedora Atomic Desktop Users**" section as well.
#### Video Tutorial
##### Video Tutorial
https://www.youtube.com/watch?v=Vs4cneBW5ck
### **Option 2**: Older & Buggy Net-Installer (Not Recommended)
#### **Option 2**: Older & Buggy Net-Installer (Not Recommended)
> **Note**: This is intended as a last resort!
@ -63,10 +69,10 @@ There is an older [video](https://www.youtube.com/watch?v=doQW1FyAISQ) showcasin
After installing it and making it to the desktop, then you will have to **rebase** to a signed image:
```command
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/<IMAGE>
```
Replace `<IMAGE>` with the image you're using.
Reboot when the rebasing process has finished, and you will know because it will tell you to reboot your device.
@ -80,5 +86,6 @@ ujust _install-system-flatpaks
> Choose the "Flathub" remote.
**This command installs:**
- [Flatpak applications for **KDE Plasma** images](https://github.com/ublue-os/bazzite/blob/9f6f5e143b7545d06803e70e7723997400bd8b88/system_files/desktop/kinoite/usr/share/ublue-os/bazzite/flatpak/install)
- [Flatpak applications for **GNOME** images](https://github.com/ublue-os/bazzite/blob/9f6f5e143b7545d06803e70e7723997400bd8b88/system_files/desktop/silverblue/usr/share/ublue-os/bazzite/flatpak/install)

24
docs/src/General/reporting_bugs.md
View File

@ -1,37 +1,45 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=3402", "fetched_at": "2024-09-03 16:43:15.937921+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Submit bug reports in the appropriate place
## Submit bug reports in the appropriate place
Report bugs experienced with Bazzite in our [**issue tracker**](https://github.com/ublue-os/bazzite/issues)! We discourage reporting bugs in the Discourse forums since reports can get lost or may not be viewed by Bazzite contributors as often as the issue tracker.
# Before submitting an issue
## Before submitting an issue
**Read [how to file an issue properly](https://universal-blue.discourse.group/docs?topic=1470) before proceeding!**
### **Bazzite Issue Template Walkthrough**
#### **Bazzite Issue Template Walkthrough**
![Bug report|690x174](../img/Bug_report.png)
![Template|690x436](../img/Bug_report_template.png)
## Update Bazzite before reporting
### Update Bazzite before reporting
Sometimes bugs are fixed during upgrades, so try updating and rebooting your device before submitting a report to see if the issue still persists between updates.
**Read how to update Bazzite for your device**:
[Updating guide](../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/updating_guide.md)
## Make sure to attach system logs
### Make sure to attach system logs
Open a host terminal and **enter**:
```
ujust device-info
```
Attach the link that it outputs for system logs.
### Experience system crashes?
#### Experience system crashes?
```command
ujust logs-last-boot
```

32
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/ASUS_ROG_Ally.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2414", "fetched_at": "2024-09-03 16:43:21.670173+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -29,6 +34,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- Adjust the scaling of the UI in the Display Settings
- Set a charge limit in HHD with Handheld Daemon
- Install Decky + the [CSS Loader plugin](https://deckthemes.com/download/deck) and then in Desktop Mode, open the "Terminal" application and enter:
```
ujust install-hhd-controller-glyph-theme
```
@ -57,34 +63,33 @@ ujust install-hhd-controller-glyph-theme
<hr>
# Additional Information
## Additional Information
This applies to most handhelds running Bazzite.
## TDP Controls
### TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
There are a few options for TDP Controls that work with Bazzite:
* The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
* Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
* Steam Quick Access Menu TDP limit (part of Steam Gaming Mode)
* [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
* Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
- Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
- Steam Quick Access Menu TDP limit (part of Steam Gaming Mode)
- [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
## How do I open the HHD Overlay?
### How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
![Settings Example|690x431, 75%](../../img/HHD_Settings_Example.jpeg)
Press, hold, or double-tap the Quick Access Menu button.
> **Note**: ASUS ROG Ally does not support **holding** for the QAM button!
## Controller Information
### Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -92,7 +97,7 @@ If your device has paddles, you will want to use the DualSense Edge controller.
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
### Desktop 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.
@ -104,14 +109,15 @@ Desktop Mode Controller Layout: It may not exist by default if Steam doesn't se
Make sure to **apply** the desktop controls when you select them.
## Force reboot device to prevent drive corruption if Steam crashes
### Force reboot device to prevent drive corruption if Steam crashes
> **Note**: This is only for the ASUS ROG Ally and Lenovo Legion Go.
Hold down the "**select**" button on your device to force a reboot. This feature can be disabled in the overlay settings.
<hr>
# Contributing
## Contributing
This page and all of the links to each specific handheld are **wikis**, 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](https://universal-blue.discourse.group/docs?topic=890) and [contributing guidelines](https://universal-blue.discourse.group/docs?topic=81) before adding any edits.

56
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayaneo_Handhelds.md
View File

@ -1,8 +1,14 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2417", "fetched_at": "2024-09-03 16:43:20.646543+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Ayaneo Geek 1S
![photo_5875160389711413569_y|663x500, 100%](../../img/Ayaneo_Geek_1S.jpeg)
**Status**: Silver
@ -21,6 +27,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- HHD'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 with `rpm-ostree kargs --editor`.
- Audio driver does work but needs to adjusted to support the 3.5mm jack.
- Either install [this rpm package](https://drive.google.com/drive/folders/1ShnESXQ1aFQjbe0mVW5b6VBrfrgDA2O6?usp=sharing) that was created using [this guide](https://www.reddit.com/r/Fedora/comments/wir3cq/guide_adding_custom_files_to_the_root_filesystem/).
@ -30,12 +37,13 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- see suspend workaround [here](https://universal-blue.discourse.group/t/ayaneo-handheld-compatibility/2417#p-5599-suspend-workaround-5)
- VRAM size option is missing from BIOS as it's controlled by AYASPACE application under windows.
## Functional HHD**:
### Functional HHD\*\*:
```
sudo systemctl enable --now hhd@$(whoami)
```
## External Graphics:
### 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**:
@ -44,7 +52,7 @@ sudo systemctl enable --now hhd@$(whoami)
- In order to boot with eGPU attached you need to add a kernel parameter, seems to be related to [this kernel issue](https://lore.kernel.org/lkml/20240415163056.GP223006@ziepe.ca/). There are many other issues opened and according to [this](https://gitlab.freedesktop.org/drm/amd/-/issues/3182) 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 and probably doesn't work.
## Suspend workaround
### Suspend workaround
> Thanks to ChimeraOS for the [original suspend workaround](https://github.com/ChimeraOS/chimeraos/wiki/Community-Guides#enabling-modern-sleep-on-7000-series-amd-hardware), and SteamFork for the [updated writeup](https://wiki.steamfork.org/troubleshooting/#enabling-modern-sleep-on-7000-series-amd-based-devices) of this workaround.
@ -58,17 +66,17 @@ sudo systemctl enable --now hhd@$(whoami)
>
> Bazzite takes no responsibility for any harm caused by following these steps. By following this guide you acknowledge that you are solely responsible for the outcome.
## Modern Standby Enablement Methods
### Modern Standby Enablement Methods
* Enter your bios/firmware settings to see if you already have the options listed in the steps for the [Enabling Modern Standby](https://universal-blue.discourse.group/t/ayaneo-handheld-compatibility/2417#p-5599-enabling-modern-standby-7) section of this guide. If so, skip the rest of this section.
* If the options are not available, follow the next few steps to create boot media.
* Format a USB stick with FAT32.
* Download [Smokeless UMAF](https://github.com/DavidS95/Smokeless_UMAF/raw/main/UMAF_BETA.zip).
* Extract `UMAF_Beta.zip` and copy the contents into the root of the usb stick.
* Boot your device and select the USB stick from the boot menu.
* Navigate to the `Front Page` tab and select `Device Manager`.
- Enter your bios/firmware settings to see if you already have the options listed in the steps for the [Enabling Modern Standby](https://universal-blue.discourse.group/t/ayaneo-handheld-compatibility/2417#p-5599-enabling-modern-standby-7) section of this guide. If so, skip the rest of this section.
- If the options are not available, follow the next few steps to create boot media.
- Format a USB stick with FAT32.
- Download [Smokeless UMAF](https://github.com/DavidS95/Smokeless_UMAF/raw/main/UMAF_BETA.zip).
- Extract `UMAF_Beta.zip` and copy the contents into the root of the usb stick.
- Boot your device and select the USB stick from the boot menu.
- Navigate to the `Front Page` tab and select `Device Manager`.
### Enabling Modern Standby
#### Enabling Modern Standby
1. Select `AMD PBS` then `Power Saving Configurations`.
2. Under `S3/Modern Standby Support` change the entry to `Modern Standby` (or `Modern Standby Enable` on some devices).
@ -77,36 +85,36 @@ sudo systemctl enable --now hhd@$(whoami)
Note: The first restart after this change may take longer than usual.
## External Resource
### External Resource
Check out the [original thread](https://universal-blue.discourse.group/t/ayaneo-geek-1s-2s-linux-bazzite-support-is-already-almost-there-lets-add-them-to-the-officially-supported-devices/1046) for more information and updates on this device.
<hr>
# Additional Information
## Additional Information
This applies to most handhelds running Bazzite.
## TDP Controls
### TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
There are a few options for TDP Controls that work with Bazzite:
* The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
* Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
* [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
* Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
* [PowerControl](https://github.com/mengmeet/PowerControl) supports TDP, GPU, and fan controls on select devices.
- The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
- Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
- [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- [PowerControl](https://github.com/mengmeet/PowerControl) supports TDP, GPU, and fan controls on select devices.
## How do I open the HHD Overlay?
### How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
![Settings Example|690x432, 75%](../../img/HHD_Settings_Example.jpeg)
Press, hold, or double-tap the Quick Access Menu button.
## Controller Information
### Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -114,7 +122,7 @@ If your device has paddles, you will want to use the DualSense Edge controller.
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
### Desktop 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.
@ -128,7 +136,7 @@ Make sure to **apply** the desktop controls when you select them.
<hr>
# Contributing
## 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](https://universal-blue.discourse.group/docs?topic=890) and [contributing guidelines](https://universal-blue.discourse.group/docs?topic=81) before adding any edits.

52
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayn_Handhelds.md
View File

@ -1,18 +1,23 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2416", "fetched_at": "2024-09-03 16:43:21.928758+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Ayn Loki Max
## Ayn Loki Max
![Loki Max|375x500, 100%](../../img/Loki_Max.jpeg)
**Status**: Platinum
## Installing Bazzite
### Installing Bazzite
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
- Complete the Bazzite Portal
- Login to Steam
@ -20,34 +25,35 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- Configure the HHD Overlay by opening it with QAM button
- Virtual keyboard is Steam's keyboard, but needs to be setup in Steam's settings in Desktop Mode (See "Desktop Controls" section below)
## Optional Tweaks
### Optional Tweaks
- Adjust RGB with Steam Gaming Mode under `Settings > Controller > Calibration & Advanced > LED Settings` or in Handheld Daemon
- Adjust the scaling of the UI in the Display Settings
- Set a charge limit in HHD with Handheld Daemon
- Install Decky + the [CSS Loader plugin](https://deckthemes.com/download/deck) and then in Desktop Mode, open the "Terminal" application and enter:
```
ujust install-hhd-controller-glyph-theme
```
## Workarounds / Known Issues
### 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 `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.
# Ayn Loki Mini Pro
## Ayn Loki Mini Pro
![loki_mini_pro|666x500, 100%](../../img/loki_mini_pro.jpeg)
**Status**: Silver
## Installing Bazzite
### Installing Bazzite
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
- Complete the Bazzite Portal
- Login to Steam
@ -55,19 +61,21 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- Configure the HHD Overlay by opening it with QAM button
- Virtual keyboard is Steam's keyboard, but needs to be setup in Steam's settings in Desktop Mode (See "Desktop Controls" section below)
## Optional Tweaks
### Optional Tweaks
- Adjust RGB with Steam Gaming Mode under `Settings > Controller > Calibration & Advanced > LED Settings` or in Handheld Daemon
- Adjust the scaling of the UI in the Display Settings
- Set a charge limit in HHD with Handheld Daemon
- Install Decky + the [CSS Loader plugin](https://deckthemes.com/download/deck) and then in Desktop Mode, open the "Terminal" application and enter:
```
ujust install-hhd-controller-glyph-theme
```
## Workarounds / Known Issues
### 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 `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.
@ -76,29 +84,29 @@ ujust install-hhd-controller-glyph-theme
<hr>
# Additional Information
## Additional Information
This applies to most handhelds running Bazzite.
## TDP Controls
### TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
There are a few options for TDP Controls that work with Bazzite:
* The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
* Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
* [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
* Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
- Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
- [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
## How do I open the HHD Overlay?
### How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
![RGB|690x431, 75%](../../img/HHD_RGB.jpeg)
Press, hold, or double-tap the Quick Access Menu button.
## Controller Information
### Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -106,7 +114,7 @@ If your device has paddles, you will want to use the DualSense Edge controller (
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
### Desktop 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.
@ -120,7 +128,7 @@ Make sure to **apply** the desktop controls when you select them.
<hr>
# Contributing
## 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](https://universal-blue.discourse.group/docs?topic=890) and [contributing guidelines](https://universal-blue.discourse.group/docs?topic=81) before adding any edits.

41
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/GPD_Handhelds.md
View File

@ -1,18 +1,23 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2418", "fetched_at": "2024-09-03 16:43:21.260488+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# GPD Win 4
## GPD Win 4
![gpdwin4|690x328, 100%](../../img/gpdwin4.jpeg)
**Status**: Gold
## Installing Bazzite
### Installing Bazzite
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
- Complete the Bazzite Portal
- Login to Steam
@ -22,7 +27,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- <kbd>Xbox</kbd> + <kbd>X</kbd> (This can be remapped)
- GPD devices also have a physical switch you can toggle to enable a separate desktop/mouse mode.
## Optional Tweaks
### Optional Tweaks
- Adjust RGB with Steam Gaming Mode in Handheld Daemon
- Adjust the scaling of the UI in the Display Settings
@ -33,7 +38,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
ujust install-hhd-controller-glyph-theme
```
## Workarounds / Known Issues
### Workarounds / Known Issues
- Suspend-resume fully works on the 6800u Win 4 after disabling the fingerprint scanner, but there are a few user reports of the 7840u and newer models having only partially working suspend-resume.
- It seems to be very similar/related to the suspend issue on the GPD WM2 7840u and newer devices, more details [here](https://gitlab.freedesktop.org/drm/amd/-/issues/3154)
@ -45,23 +50,23 @@ ujust install-hhd-controller-glyph-theme
- Manually remap back buttons as described in hhd docs [here](https://github.com/hhd-dev/hhd?tab=readme-ov-file#extra-steps-gpd-win-devices)
- Watch this [video](https://www.youtube.com/watch?v=lnNfMY9kzjk) if you need a visual guide.
## External Resource
### External Resource
For more information, check out the [GPD Win Tips and Tricks guide](https://github.com/aarron-lee/gpd-win-tricks) which includes useful scripts for this handheld.
<hr>
# GPD Win Max 2
## GPD Win Max 2
![placeholder_gpdwinmax2|407x312, 100%](../../img/GPD_Win_Max_2.png)
**Status**: Gold
## Installing Bazzite
### Installing Bazzite
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
- Complete the Bazzite Portal
- Login to Steam
@ -74,7 +79,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- Steam Gaming Mode **Display** settings that are recommended to be changed:
- `Use Native Color Temperature` - Enabled
## Optional Tweaks
### Optional Tweaks
- Adjust RGB with Steam Gaming Mode in Handheld Daemon
- Adjust the scaling of the UI in the Display Settings
@ -85,7 +90,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
ujust install-hhd-controller-glyph-theme
```
## Workarounds / Known Issues
### Workarounds / Known Issues
- Suspend-resume works on the WM2 6800u model after disabling the fingerprint scanner, but 7840u and newer models have only partially working suspend-resume.
- Read about the issue [here](https://gitlab.freedesktop.org/drm/amd/-/issues/3154) for details on suspend-resume issues for the newer WM2 devices.
@ -98,17 +103,17 @@ ujust install-hhd-controller-glyph-theme
- Manually remap back buttons as described in hhd docs [here](https://github.com/hhd-dev/hhd?tab=readme-ov-file#extra-steps-gpd-win-devices)
- Watch this [video](https://www.youtube.com/watch?v=lnNfMY9kzjk) if you need a visual guide.
## External Resource
### External Resource
For more information, check out the [GPD Win Tips and Tricks guide](https://github.com/aarron-lee/gpd-win-tricks) which includes useful scripts for this handheld.
<hr>
# Additional Information
## Additional Information
This applies to most handhelds running Bazzite.
## TDP Controls
### TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
@ -120,7 +125,7 @@ There are a few options for TDP Controls that work with Bazzite:
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- [PowerControl](https://github.com/mengmeet/PowerControl) supports TDP, GPU, and fan controls on select devices.
## How do I open the HHD Overlay?
### How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
![Emulation Mode|690x434, 75%](../../img/HHD_Emulation_Mode.jpeg)
@ -129,7 +134,7 @@ Press, hold, or double-tap the Quick Access Menu button.
> **Note**: GPD devices do not support double-tapping the QAM button!
## Controller Information
### Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -137,7 +142,7 @@ If your device has paddles, you will want to use the DualSense Edge controller.
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
### Desktop 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.
@ -151,7 +156,7 @@ Make sure to **apply** the desktop controls when you select them.
<hr>
# Contributing
## 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](https://universal-blue.discourse.group/docs?topic=890) and [contributing guidelines](https://universal-blue.discourse.group/docs?topic=81) before adding any edits.

29
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Lenovo_Legion_Go.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2413", "fetched_at": "2024-09-03 16:43:19.836067+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -28,6 +33,7 @@ Open a host terminal and enter the following **commands**:
- Adjust the scaling of the UI in the Display Settings
- Set a charge limit in HHD with Handheld Daemon
- Install Decky + the [CSS Loader plugin](https://deckthemes.com/download/deck) and then in Desktop Mode, open the "Terminal" application and enter:
```
ujust install-hhd-controller-glyph-theme
```
@ -58,33 +64,32 @@ For more information, check out the [Legion Go Tips and Tricks guide](https://gi
<hr>
# Additional Information
## Additional Information
This applies to most handhelds running Bazzite.
## TDP Controls
### TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
There are a few options for TDP Controls that work with Bazzite:
* The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
* Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
* [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
* Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
- Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
- [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
## How do I open the HHD Overlay?
### How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
![Legion HHD|690x431, 75%](../../img/HHD_Settings_Example.jpeg)
Press, hold, or double-tap the Quick Access Menu button.
> **Example**: <kbd>Legion R</kbd> for the Lenovo Legion Go.
## Controller Information
### Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -92,7 +97,7 @@ If your device has paddles, you will want to use the DualSense Edge controller.
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
### Desktop 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.
@ -104,7 +109,7 @@ Desktop Mode Controller Layout: It may not exist by default if Steam doesn't se
Make sure to **apply** the desktop controls when you select them.
## Force reboot device to prevent drive corruption if Steam crashes
### Force reboot device to prevent drive corruption if Steam crashes
> **Note**: This is only for the ASUS ROG Ally and Lenovo Legion Go.
@ -112,7 +117,7 @@ Hold down the "**select**" button on your device to force a reboot. This feature
<hr>
# Contributing
## 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](https://universal-blue.discourse.group/docs?topic=890) and [contributing guidelines](https://universal-blue.discourse.group/docs?topic=81) before adding any edits.

26
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Other_Handhelds.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2415", "fetched_at": "2024-09-03 16:43:17.984951+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -8,7 +13,7 @@
> Certain handhelds have been confirmed to boot Bazzite, but are plagued by missing driver support for Linux including missing audio drivers.
Unsupported handhelds *could work* with Bazzite and the "**Other Handhelds**" section should cover unsupported handhelds, but there may be major issues encountered that are undocumented. If your handheld hardware is not listed, then you can still give Bazzite a try with our Handheld/HTPC image.
Unsupported handhelds _could work_ with Bazzite and the "**Other Handhelds**" section should cover unsupported handhelds, but there may be major issues encountered that are undocumented. 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. Bazzite does **not** have the required setup for unsupported handheld, so setup will be manually done by the end user with unsupported handhelds.
@ -21,29 +26,30 @@ systemctl start hhd@yourusername
```command
systemctl enable hhd@yourusername
```
> **Note**: Replace `yourusername` with your Bazzite username.
<hr>
# TDP Controls
## TDP Controls
![TDP|690x431, 75%](../../img/TDP.jpeg)
There are a few options for TDP Controls that work with Bazzite:
* The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
* Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
* [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
* Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
* [PowerControl](https://github.com/mengmeet/PowerControl) supports TDP, GPU, and fan controls on select devices.
- The [HHD-overlay](https://github.com/hhd-dev/hhd/blob/master/readme.md) supports TDP controls.
- Also has a desktop app that is pre-installed, look for the Handheld Daemon app in Desktop Mode.
- [SimpleDeckyTDP](https://github.com/aarron-lee/SimpleDeckyTDP) supports TDP, GPU, Power Governor, and among other settings.
- Also has a [graphical application](https://github.com/aarron-lee/SimpleDeckyTDP-Desktop), but needs to be manually installed.
- [PowerControl](https://github.com/mengmeet/PowerControl) supports TDP, GPU, and fan controls on select devices.
# How do I open the HHD Overlay?
## How do I open the HHD Overlay?
![Overlay|690x431, 75%](../../img/HHD_Overlay.jpeg)
Press, hold, or double-tap the Quick Access Menu button.
# Controller Information
## Controller Information
For most handheld hardware, besides the Steam Deck, emulation of a DualSense controller is used 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.
@ -51,7 +57,7 @@ If your device has paddles, you will want to use the DualSense Edge controller (
Some games and emulators may need Steam Input **disabled** to work correctly with your controls.
## Desktop 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.

48
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Steam_Deck.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1849", "fetched_at": "2024-09-03 16:43:16.550432+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# Steam Deck LCD (256GB+)
## Steam Deck LCD (256GB+)
![Steam Deck LCD|690x348, 100%](../../img/Steam_Deck_LCD.jpeg)
@ -12,7 +17,7 @@
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
- No additional setup required, but make sure to read the [installation Guide](https://universal-blue.discourse.group/docs?topic=30).
- It should function nearly identical to SteamOS with the benefits of [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/):
@ -21,7 +26,7 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
- Printing support and other basic features that would make Bazzite viable for daily usage.
- View our [FAQ](https://universal-blue.discourse.group/docs?topic=33) for more information.
# Steam Deck OLED
## Steam Deck OLED
![Steam Deck OLED|667x500, 100%](../../img/Steam_Deck_OLED.jpeg)
@ -31,18 +36,19 @@ Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os
Read the [**Installing Bazzite on Handheld PCs documentation**](https://ublue-os.github.io/bazzite/General/Installation_Guide/Installing_Bazzite_for_Handheld_PCs/).
## Post-Installation Setup
### Post-Installation Setup
* No additional setup required, but make sure to read the [installation Guide](https://universal-blue.discourse.group/docs?topic=30).
* It should function nearly identical to SteamOS with the benefits of [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/):
* 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](https://universal-blue.discourse.group/docs?topic=33) for more information.
- No additional setup required, but make sure to read the [installation Guide](https://universal-blue.discourse.group/docs?topic=30).
- It should function nearly identical to SteamOS with the benefits of [Fedora Atomic Desktop](https://fedoraproject.org/atomic-desktops/):
- 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](https://universal-blue.discourse.group/docs?topic=33) for more information.
<hr>
# How similar is Bazzite to SteamOS on Steam Deck hardware?
## How similar is Bazzite to SteamOS on Steam Deck hardware?
Bazzite should have most of the functionality from SteamOS with Steam Gaming Mode working as intended.
Bazzite Steam Deck images include the latest Gamescope and packages, which means we are always ahead of SteamOS in terms of Steam Gaming Mode and Desktop Mode features.
@ -51,11 +57,12 @@ The Quick Access Menu (accessed with the <kbd>...</kbd> button on Steam Deck) is
Third-party software like [Decky Loader](https://decky.xyz/), [Emudeck](https://www.emudeck.com/), [RetroDeck](https://retrodeck.net/), etc. should install and function properly.
# Why should I use Bazzite over SteamOS?
## Why should I use Bazzite over SteamOS?
Bazzite is great for users who feel that the device is too limited by SteamOS in comparison to other Linux operating systems, but do not want to sacrifice Steam Gaming Mode, stability, and the user friendliness of SteamOS.
## Enhancements
### Enhancements
- Shares packages from SteamOS
- Works on different hardware configurations (desktops, handhelds, etc.)
- Android applications can be installed with [Waydroid](https://universal-blue.discourse.group/docs?topic=32/)
@ -65,7 +72,7 @@ Bazzite is great for users who feel that the device is too limited by SteamOS in
- GNOME
- Budgie (**coming soon**)
## Daily Driving
### Daily Driving
- System packages that get updated on a regular basis
- Follows Fedora's [update cycle](https://docs.fedoraproject.org/en-US/releases/lifecycle/) and receive updates directly from upstream
@ -74,17 +81,18 @@ Bazzite is great for users who feel that the device is too limited by SteamOS in
- Printing support out of the box
- Wayland is the default session for Desktop Mode
## Tinkering
### Tinkering
- Access to multiple package managers and repositories in [containers](https://universal-blue.discourse.group/docs?topic=44)
- [Layer](https://universal-blue.discourse.group/docs?topic=513) Fedora packages to the system which survive between updates
- [`ujust`](https://universal-blue.discourse.group/docs?topic=42) commands to easily setup anything from virtualization support to supporting specific input peripherals
# Will there be any performance improvements with Bazzite?
## Will there be any performance improvements with Bazzite?
Performance should be on par with SteamOS, and every game capable of running on SteamOS should run on Bazzite. Bazzite and SteamOS share the same packages, so the difference is usually negligible.
However there are some **advantages** that Bazzite may have in some edge cases:
- Performance Governor
- Bazzite uses powersave w/ [`amd-pstate`](https://www.kernel.org/doc/html/latest/admin-guide/pm/amd-pstate.html) which is more efficient on the hardware
- MGLRU is already enabled by default by Fedora
@ -98,24 +106,26 @@ However there are some **advantages** that Bazzite may have in some edge cases:
> Performance tweaks are sourced from this [Medium article](https://medium.com/@a.b.t./here-are-some-possibly-useful-tweaks-for-steamos-on-the-steam-deck-fcb6b571b577).
# Does the Steam Deck image receive BIOS updates like SteamOS?
## Does the Steam Deck image receive BIOS updates like SteamOS?
**Yes**.
If a BIOS update is available then it will install when you update Bazzite normally. It also supports controller firmware updates too.
If desired, there is a **command to disable BIOS updates** at your own risk:
```
ujust disable-bios-updates
```
# Why is the stock 64GB Steam Deck not supported on Bazzite?
## Why is the stock 64GB Steam Deck not supported on Bazzite?
It has **filesystem corruptions**.
You will have booting issues, freezes, and will not be able to update the image.
## Solution
### Solution
**At your own risk**:
Upgrade the storage to resolve this.

20
docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/index.md
View File

@ -1,6 +1,9 @@
---
title: Handheld Wiki
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=1038", "fetched_at": "2024-09-03 16:43:15.186486+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -11,14 +14,14 @@ title: Handheld Wiki
> **Note**: All handhelds except for the Steam Deck make use of [Handheld Daemon](https://github.com/hhd-dev/hhd/blob/master/readme.md) for controls, TDP, etc.
*Click the name of each hardware to view post-installation setup and known issues/workarounds.*
_Click the name of each hardware to view post-installation setup and known issues/workarounds._
- [**Steam Deck**](./Steam_Deck.md)
- [**Lenovo Legion Go**](./Lenovo_Legion_Go.md) ([*Edit Wiki*](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Lenovo_Legion_Go.md))
- [**ASUS ROG Ally**](./ASUS_ROG_Ally.md) ([*Edit Wiki*](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/ASUS_ROG_Ally.md))
- [**Ayn Handhelds**](./Ayn_Handhelds.md) ([*Edit Wiki*](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayn_Handhelds.md))
- [**GPD Handhelds**](./GPD_Handhelds.md) ([*Edit Wiki*](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/GPD_Handhelds.md))
- [**Ayaneo Handhelds**](./Ayaneo_Handhelds.md) ([*Edit Wiki*](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayaneo_Handhelds.md))
- [**Lenovo Legion Go**](./Lenovo_Legion_Go.md) ([_Edit Wiki_](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Lenovo_Legion_Go.md))
- [**ASUS ROG Ally**](./ASUS_ROG_Ally.md) ([_Edit Wiki_](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/ASUS_ROG_Ally.md))
- [**Ayn Handhelds**](./Ayn_Handhelds.md) ([_Edit Wiki_](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayn_Handhelds.md))
- [**GPD Handhelds**](./GPD_Handhelds.md) ([_Edit Wiki_](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/GPD_Handhelds.md))
- [**Ayaneo Handhelds**](./Ayaneo_Handhelds.md) ([_Edit Wiki_](https://github.com/ublue-os/bazzite/blob/main/docs/src/Handheld_and_HTPC_edition/Handheld_Wiki/Ayaneo_Handhelds.md))
- [**Other Handhelds**](./Other_Handhelds.md)
## Support Rating
@ -40,7 +43,7 @@ Major issues and/or exhaustive workarounds, but boots and displays a desktop.
**Borked**:
Bazzite does not boot on this hardware.
**Unknown** (*unlisted*):
**Unknown** (_unlisted_):
The handheld is not listed here and a general guide is under “Other Handhelds.”
# HHD Setup
@ -55,7 +58,6 @@ The handheld is not listed here and a general guide is under “Other Handhelds.
> **Note**: Gyro functionality **requires** DualSense emulation
# Decky Plugins
> **Note**: Decky may break or uninstall after updates especially if the Steam client or Gamescope is updated.
@ -71,12 +73,14 @@ Check out the [Steam Gaming Mode documentation](../Steam_Gaming_Mode.md) for an
> eGPU is **not** a fully supported feature and has many caveats.
**Notes**:
- Modern AMD GPUs are **supported**.
- Intel ARC GPUs are **supported**.
- Nvidia GPUs are **unsupported**.
- Proprietary connectors, like the one for the ASUS ROG Ally, will not work.
## **Recommended External Guide & Script**:
Read this [guide](https://github.com/ewagner12/all-ways-egpu) for eGPU usage on Linux, and use the script at your own risk.
<hr>

71
docs/src/Handheld_and_HTPC_edition/Steam_Gaming_Mode.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=37", "fetched_at": "2024-09-03 16:43:12.251158+00:00"}-->
<!-- ANCHOR_END: METADATA -->
# General Information
## General Information
> **For Handheld PC users only**: View our [Handheld Wiki](../Handheld_and_HTPC_edition/Handheld_Wiki/index.md) for post-installation setup, workarounds, and known issues on handheld hardware.
@ -10,7 +15,7 @@
> Steam Gaming Mode requires a modern AMD graphics card or an Intel Arc graphics card. Nvidia is **not** supported.
## What is Steam Gaming Mode?
### What is Steam Gaming Mode?
https://www.youtube.com/watch?v=zXK1CXUyzXQ
**Steam Deck UI Tour by [Linux For Everyone](https://www.youtube.com/@LinuxForEveryone)**
@ -19,7 +24,7 @@ Bazzite utilizes Steam Gaming Mode by [forking ChimeraOS’s `gamescope-session`
Steam Gaming Mode is what SteamOS on the Steam Deck is built around. A simple interface that is controller-friendly built around Steam's "Big Picture Mode" UI/UX. The minimal session only runs the bare minimum in the background, so most of the hardware resources is going towards the game being played. [Gamescope](https://github.com/ValveSoftware/gamescope) is the main ingredient in Steam Gaming Mode which gives users options to set a framerate cap, resolution scaling options, etc.
## What are the HTPC/Handheld Images?
### What are the HTPC/Handheld Images?
> **Note**: The Steam beta client is **not** supported, please revert to the stable client before reporting issues.
@ -31,11 +36,11 @@ This documentation may not cover specific areas with the assumption that the use
<hr>
# Common Questions & Issues for Steam Gaming Mode
## Common Questions & Issues for Steam Gaming Mode
> [View the current Gamescope issues](https://github.com/ValveSoftware/gamescope/issues).
## How do I open the on-screen keyboard?
### How do I open the on-screen keyboard?
> **Note**: Steam must be running to access the keyboard.
@ -43,68 +48,74 @@ This documentation may not cover specific areas with the assumption that the use
- For other handhelds it may require turning on Desktop Controls and configuring it manually.
- After that it is usually a combination of <kbd>X</kbd> (or equivalent) + one of the specific buttons your handheld has and it may also not be configured for your device out of the box.
## Update and Changelog Inaccuracy
### Update and Changelog Inaccuracy
> **Note**: Updates will also look for and upgrade Linux applications like installed [Flatpaks](https://universal-blue.discourse.group/docs?topic=2636).
### Steam Gaming Mode
#### Steam Gaming Mode
The update indicator is not accurate and will most likely look it's stuck at "99%" for a long time. This is due to the update component not containing a live progress indicator, so it cannot hook into Steam Gaming Mode properly. After a while, the update progress bar will appear done and ask for a reboot.
### Desktop Mode
In Desktop Mode, run our *System Update* tool for an accurate update visual if you are unsure if your system has actually updated properly in Gaming Mode. When the update has finished, it will output what has completed successfully. Alternatively, open a host terminal and **enter**:
#### Desktop Mode
In Desktop Mode, run our _System Update_ tool for an accurate update visual if you are unsure if your system has actually updated properly in Gaming Mode. When the update has finished, it will output what has completed successfully. Alternatively, open a host terminal and **enter**:
```command
ujust update
```
### Changelog
#### Changelog
The changelog is specifically for SteamOS by Valve, so the upgrade for Bazzite may not apply.
Read the [Universal Blue announcements](https://universal-blue.discourse.group/tag/announcements) for major changes and features.
View a changelog to the next update in the terminal by **entering**:
```
ujust changelogs
```
## How do I access GRUB?
### How do I access GRUB?
[GRUB](https://www.gnu.org/software/grub/manual/grub/grub.html#Overview) used to be hidden by default, but new installations have defaulted to showing it.
Keep in mind, other handhelds and controllers may not be able to unhide GRUB without a physical keyboard connected, but a `ujust` command can be performed to unhide it permanently.
Enter this command in the terminal to have it appear every boot:
```
ujust configure-grub
```
Select "unhide" to have GRUB appear on boot.
Select "unhide" to have GRUB appear on boot.
> View the [Rollback Guide](../Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rolling_back_system_updates.md) for more information.
## How do I open the Quick Access Menu (QAM) with a physical keyboard?
### How do I open the Quick Access Menu (QAM) with a physical keyboard?
<kbd>Ctrl</kbd>+<kbd>2</kbd>
## Change physical keyboard layout for Steam Gaming Mode
### Change physical keyboard layout for Steam Gaming Mode
As of writing, `gamescope-session` has no way to change the physical keyboard layout and will default to the US layout.
If you want to change the layout for Gamescope, you can set the environment variable `XKB_DEFAULT_LAYOUT=no` replacing `no` with the correct layout for you. Add this to `~/.config/environment.d/10-gamescope-session.conf`
> If the file or folder does not exist then create it.
This works on desktop mode including running Nested Gamescope and also works for Steam Gaming Mode, but it has its own quirks: <kbd>altgr</kbd> + <kbd>2</kbd> to write "<kbd>@</kbd>" on the Norwegian layout will still not work, but the basic keyboard layout will always work, `altgr` is luckily not needed for normal typing on the norwegian layout, however <kbd>altgr</kbd> has been reported to work on the French layout, but your mileage may vary.
## Why do specific Decky Loader plugins not function on Bazzite?
### Why do specific Decky Loader plugins not function on Bazzite?
Some plugins are built specifically for SteamOS or the Steam Deck, and won’t necessarily work on Bazzite or non-Deck hardware.
For example, the [DeckMTP plugin](https://github.com/dafta/DeckMTP) only works on the Steam Deck, it will not work on alternative hardware.
## How do I use SteamDeckGyroDSU on hardware that isn't the Steam Deck?
### How do I use SteamDeckGyroDSU on hardware that isn't the Steam Deck?
You cannot use SteamDeckGyroDSU outside of the Steam Deck, but you can try disabling Steam Input and it *may* work depending on your hardware and use case.
You cannot use SteamDeckGyroDSU outside of the Steam Deck, but you can try disabling Steam Input and it _may_ work depending on your hardware and use case.
## How do I disable certain "Steam Deck" features that conflict with my setup?
### How do I disable certain "Steam Deck" features that conflict with my setup?
**Scenarios**:
@ -118,8 +129,10 @@ Open the game's properties on Steam and **enter this launch option**:
SteamDeck=0 %command%
```
## How do I specify the correct monitor for Gaming Mode to use? (HTPC only)
### How do I specify the correct monitor for Gaming Mode to use? (HTPC only)
Go into desktop mode and open `ptyxis` our terminal and run
```command
mkdir ~/.config/environment.d
nano ~/.config/environment.d/10-gamescope-session.conf
@ -129,6 +142,7 @@ add this to the file:
`OUTPUT_CONNECTOR=DP-1`
change `DP-1` to the correct output.
You can find your display outputs on KDE using the command
```
kscreen-doctor -o
```
@ -141,7 +155,7 @@ gnome-randr
Save with <kbd>CTRL</kbd> + <kbd>X</kbd> then pressing <kbd>Y</kbd> followed by <kbd>ENTER</kbd>
## How do I specify which GPU that Steam Gaming Mode should use?
### How do I specify which GPU that Steam Gaming Mode should use?
1. Open a TTY session with an **external physical keyboard** using this **keyboard combination**:
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>F4</kbd>
@ -151,27 +165,28 @@ export-gpu
```
**Alternatively**, in Desktop Mode, enter in a host terminal:
```
/usr/bin/export-gpu
```
2. Select the GPU to use for Steam Gaming Mode.
## "Something went wrong while displaying this content" Error
### "Something went wrong while displaying this content" Error
This is most likely due to a broken Decky Loader plugin you have installed. The easiest fix is to uninstall the broken plugin. CSS Loader themes can also cause this issue.
## Audio output not working (Default Device)
### Audio output not working (Default Device)
> This issue happens usually with HDMI TV audio.
Go into Desktop Mode and into the system settings to adjust the sound settings. Disable devices that do not match the sound output that you're using. An example of this is disabling all the things that aren't HDMI for your TV audio.
## Why is VRR not working on my VRR-compatible display?
### Why is VRR not working on my VRR-compatible display?
Most of the time this is because you're connecting the device via HDMI which does not support VRR on Linux. Here is the [source](https://www.phoronix.com/news/HDMI-2.1-OSS-Rejected) of that information.
## Stuck at the Bazzite logo
### Stuck at the Bazzite logo
https://www.youtube.com/watch?v=gE1ff72g2Gk
@ -183,11 +198,11 @@ https://www.youtube.com/watch?v=gE1ff72g2Gk
3. You can move your games from the renamed `Steam1` directory to the new `Steam` directory if you had any installed previously on your internal storage
4. Exit the TTY session by entering this **keyboard combination**: <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>F2</kbd>
## I lost my "Return to Gaming Mode" shortcut
### I lost my "Return to Gaming Mode" shortcut
You can restore this shortcut by creating a text file called `Return.desktop` and adding these specific lines to it:
### KDE
#### KDE
```file
[Desktop Entry]
@ -199,7 +214,7 @@ Type=Application
StartupNotify=false
```
### GNOME
#### GNOME
```file
[Desktop Entry]
@ -215,7 +230,7 @@ Save it and place it in the `Desktop` directory.
<hr>
# Valve's Official SteamOS Guide
## Valve's Official SteamOS Guide
> **Note**: Not all of the information will be accurate in regards to Bazzite.

7
docs/src/Installing_and_Managing_Software/AppImage.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2641", "fetched_at": "2024-09-03 16:43:10.114605+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -18,8 +23,6 @@ Applications installed as an AppImage can integrate with your desktop and be man
https://appimage.org/
<hr>
[**<-- Back to Installing and Managing Software on Bazzite**](./index.md)

7
docs/src/Installing_and_Managing_Software/Distrobox.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2640", "fetched_at": "2024-09-03 16:43:09.168054+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -20,8 +25,8 @@ Distrobox containers run sub-systems of other popular [Linux distributions](http
## Arch Linux Distrobox Container Example:
![i use arch btw|690x229, 75%](../img/i_use_arch_btw.png)
>i use Arch (in a container) btw.
> i use Arch (in a container) btw.
**Linux Distribution Examples**:

17
docs/src/Installing_and_Managing_Software/Flatpak.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2636", "fetched_at": "2024-09-03 16:43:08.564302+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -8,7 +13,6 @@
Flatpak is a universal containerized package format that tries to sandbox applications through flexible permissions that the application has access to on your system.
> Flatpak is the **primary method of installing applications on Bazzite** and is recommended to use Flatpak over other formats for most software when possible.
# Installing Flatpaks
@ -16,17 +20,16 @@ Flatpak is a universal containerized package format that tries to sandbox applic
Flatpaks can be installed via the software center of the desktop environment you chose.
![Discover|50x50, 100%](../img/Discover_icon.png)
**KDE**: *Discover*
**KDE**: _Discover_
![GNOME Software|50x50, 100%](../img/Gnome_Software.png)
**GNOME**: *GNOME Software*
**GNOME**: _GNOME Software_
![Discover|659x500, 100%](../img/Discover.png)
![GNOME Software Center](../img/Gnome_Software_Center.png)
**Alternatively open a host terminal and enter**:
```
flatpak install <application>
```
@ -55,7 +58,7 @@ Manage Flatpaks with [Flatseal](https://github.com/tchx84/Flatseal) and [Warehou
Alternatively, use KDE Plasma's system settings which has application permissions to adjust as well on KDE Plasma images.
Sometimes a project's website or [Github repository](https://github.com/flathub/com.discordapp.Discord/wiki/Rich-Precense-(discord-rpc)#flatpak-applications) contain information on what permissions need to be changed to perform certain functionality.
Sometimes a project's website or [Github repository](<https://github.com/flathub/com.discordapp.Discord/wiki/Rich-Precense-(discord-rpc)#flatpak-applications>) contain information on what permissions need to be changed to perform certain functionality.
## Warehouse
@ -63,12 +66,10 @@ Sometimes a project's website or [Github repository](https://github.com/flathub/
**Warehouse** is a utility that gives users a graphical interface to downgrade applications, add other Flatpak sources outside of Flathub, and backup application user data. Its also a helpful tool for installing Flatpaks outside of Flathub, **at your own risk**.
# Project Website
https://www.flatpak.org/
<hr>
[**<-- Back to Installing and Managing Software on Bazzite**](./index.md)

6
docs/src/Installing_and_Managing_Software/Homebrew.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2639", "fetched_at": "2024-09-03 16:43:07.277727+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -6,7 +11,6 @@
![Homebrew|332x500, 15%](../img/Homebrew.png)
> **Note**: Any package that requires root privileges will either need a rootful Distrobox container or has to be layered with `rpm-ostree`.
Homebrew is a package manager that installs packages to their own prefix, and is used strictly for command-line interface (CLI) and terminal user interface (TUI) applications. Do **not** install graphical applications or anything that may override system-level packages with Homebrew.

9
docs/src/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/bazzite_rollback_helper.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2647", "fetched_at": "2024-09-03 16:43:17.164020+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -9,10 +14,13 @@
A command-line utility that assists with **rollbacks**, **rebasing**, and **information on your current image**.
Open a host terminal and **enter**:
```command
bazzite-rollback-helper
```
# Options are available to the user:
- `list` = List images from the last 90 days that can rebased to.
- `rollback` = Rollback to the previous deployment on next reboot.
- `current` = Show information about your current deployment and image.
@ -23,6 +31,7 @@ bazzite-rollback-helper
https://www.youtube.com/watch?v=XvljabnzgVo
> # Key Takeaways:
>
> **Updates**: Upgrades both system and installed software.
> **Rollbacks**: Return to a previous deployment after a bad system upgrade.
> **Rebasing**: Use the `bazzite-rollback-helper` command in the terminal.

13
docs/src/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/index.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=36", "fetched_at": "2024-09-03 16:43:15.473615+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -7,14 +12,14 @@
Updates are automatic on Desktop images and manually done on Handheld/HTPC images, and both Bazzite variants upgrade everything at both a system-level and user-installed applications during the updating process.
> **Full Documentation**:
[Updating guide](./updating_guide.md)
> [Updating guide](./updating_guide.md)
# Rollbacks
Swap back to a previous system update if there are major issues after updating via the GRUB menu or the `rpm-ostree rollback` command.
> **Full Documentation**:
[Rollbacks guide](./rolling_back_system_updates.md)
> [Rollbacks guide](./rolling_back_system_updates.md)
# Rebasing
@ -23,14 +28,14 @@ Swap back to a previous system update if there are major issues after updating v
Rebase to Bazzite builds from the last 90 days, change Bazzite update channels, swap between the Desktop and Handheld/HTPC images, or move completely to a different Fedora Atomic Desktop image.
> **Full Documentation**:
[Rebase guide](./rebase_guide.md)
> [Rebase guide](./rebase_guide.md)
## Rollback Helper
Utility to assist with rolling back and rebasing to older Bazzite images.
> **Full Documentation**:
[Rollback Helper](./bazzite_rollback_helper.md)
> [Rollback Helper](./bazzite_rollback_helper.md)
<hr>

19
docs/src/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rebase_guide.md
View File

@ -1,8 +1,13 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2646", "fetched_at": "2024-09-03 16:43:14.912897+00:00"}-->
<!-- ANCHOR_END: METADATA -->
![Docker's OCI Icon|200x200, 100%](../../img/Dockers_OCI_Icon.png)]
![Docker's OCI Icon|200x200, 100%](../../img/Dockers_OCI_Icon.png)
# What is Rebasing?
@ -13,6 +18,7 @@ Rebasing allows users to switch to a different image **without** having to reins
[**It is recommended to use the Bazzite Rollback Helper utility**](./bazzite_rollback_helper.md).
# Rebase Scenarios
- Rebase to specific images of older builds within the last 90 days if issues are occurring on the newest build of Bazzite.
- Rebase to other Fedora Atomic Desktop images including other Bazzite images.
- Do **not** rebase between different desktop environments.
@ -20,9 +26,11 @@ Rebasing allows users to switch to a different image **without** having to reins
# How do I swap between Bazzite (and other Fedora Atomic Desktop) images?
See what channel or build you are on by **entering this command in a host terminal**:
```command
rpm-ostree status
```
Check under "Deployments:" and the output should be similar to:
> **● ostree-image-signed:docker://ghcr.io/ublue-os/[*image*]:[*channel*]**
@ -30,6 +38,7 @@ Check under "Deployments:" and the output should be similar to:
Switch to another Bazzite variant by entering the command for each specific image.
Open the terminal and **enter**:
```
rpm-ostree rebase <image>
```
@ -76,9 +85,11 @@ Main (:unstable)
For Desktop images, replacing `:stable` with `:testing` or `:unstable` to the end of the rebase command for your Bazzite image allows you to switch to the experimental branches (which may have frequent bugs.)
**Example**:
```command
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite:testing
```
For the **testing** branch on the generic AMD/Intel Desktop image.
# Can I stay on a specific Fedora release?
@ -106,14 +117,18 @@ skopeo list-tags docker://ghcr.io/ublue-os/bazzite | grep -- "-stable-" | sort -
```
Rebasing to a specific build requires users to open a host terminal and **enter**:
```command
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/IMAGE-NAME:VERSION-YEARMONTHDAY
```
**Example**:
```command
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-deck:39-20240113
```
For the *Jan. 13th 2024* `bazzite-deck` (*Fedora 39*) build.
For the _Jan. 13th 2024_ `bazzite-deck` (_Fedora 39_) build.
<hr>

15
docs/src/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/rolling_back_system_updates.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2644", "fetched_at": "2024-09-03 16:43:14.300522+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -7,9 +12,11 @@
# How do I rollback a system update?
A rollback to the previous system deployment can be done by **entering this command in a host terminal**:
```command
rpm-ostree rollback
```
Rollback can also be done in the GRUB menu (the menu you see before booting into Bazzite on Desktop images) by choosing the previous boot entry before booting to the desktop. It shows your current (`:0`) and your previous (`:1`) deployments, but due to a bug upstream there may be duplicates below them. Your personal files will **not** be affected by this, and you can still update to the newest builds after rolling back.
> If you need to rollback to a different OS image, use the [`bazzite-rollback-helper`](./bazzite_rollback_helper.md) to do so.
@ -23,6 +30,7 @@ Unhide GRUB on Handheld/HTPC images with this **command**:
```
ujust configure-grub
```
Select the "**unhide**" opiton to have GRUB appear on boot.
> Controls may vary with different handheld or HTPC navigate the menu and an external physical keyboard may be needed.
@ -30,23 +38,27 @@ Select the "**unhide**" opiton to have GRUB appear on boot.
# How do I save my **current** deployment?
You can pin your **current** deployment with this **command**:
```command
sudo ostree admin pin 0
```
In a host terminal for a backup save state of your **current** deployment to rollback to if a new system update causes issues.
# How do I save my **previous** deployment?
You can pin your **previous** deployment with this **command**:
```command
sudo ostree admin pin 1
```
In a host terminal for a backup save state of your **previous** deployment to rollback if the current deployment has issues.
# How do I unpin a deployment if I saved it?
Unpin saved **current** deployment:
```command
sudo ostree admin pin --unpin 0
```
@ -64,6 +76,7 @@ rpm-ostree status -v
```
Unpin **saved** deployment:
```command
sudo ostree admin pin --unpin <index number>
```

12
docs/src/Installing_and_Managing_Software/Updates_Rollbacks_and_Rebasing/updating_guide.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2637", "fetched_at": "2024-09-03 16:43:13.297624+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -27,7 +32,6 @@ Bazzite updates all of the changes made specifically in Bazzite itself, updates
> **Note**: This manual method also works in Desktop Mode on Handheld/HTPC images in Desktop Mode.
**Note**: `rpm-ostree` does not show a progress indicator for system updates and may appear frozen, but it is not.
- You can force an update with the System Update tool at your own convenience.
@ -35,11 +39,13 @@ Bazzite updates all of the changes made specifically in Bazzite itself, updates
- This upgrades system packages, containers, and installed applications.
## Terminal command to update manually:
```command
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.
@ -47,6 +53,7 @@ ujust update
- Users will need to apply system updates manually similarly to SteamOS.
# How do I view the changelog for each update?
Open a host terminal and enter this **command**:
```
@ -72,12 +79,15 @@ Alternatively, you can subscribe to the [RSS feed](https://universal-blue.discou
Usually Bazzite is built twice a week which includes the new changes from us, but it can also be built more than this. Updates may happen multiple times a day regardless due to updates from upstream (Universal Blue and Fedora), applications installed, firmware upgrades, and any containers that exist on your system updating their packages.
# 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 release is out.
# Can I enable update notifications for Desktop images?
**Yes**
1. Open a host terminal and **enter**:
```command
sudo nano /etc/ublue-update/ublue-update.toml
```

14
docs/src/Installing_and_Managing_Software/Waydroid_Setup_Guide.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=32", "fetched_at": "2024-09-03 16:43:06.740654+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -7,6 +12,7 @@
> **Note**: Waydroid does **not** work on Nvidia's proprietary drivers, and requires an AMD or Intel GPU for the best results.
# What is Waydroid?
![Waydroid](../img/Waydroid.jpeg)
[Waydroid](https://waydro.id/) is an Android container that runs on Linux. Bazzite users can run Android applications using this method.
@ -29,6 +35,7 @@ Make sure this worked by entering this **command**:
```bash
/usr/bin/waydroid-launcher
```
This will launch Waydroid for the first time.
## Configure Waydroid
@ -46,20 +53,21 @@ waydroid session stop
### Part 2: Configuration
Open a host terminal and enter this **command**:
```
ujust setup-waydroid
```
Selecting `Configure Waydroid` will allow users to install additional Android tweaks with the [Waydroid Extras Scripts.](https://github.com/casualsnek/waydroid_script#waydroid-extras-script)
1. Select Android Version (***Android 11* recommended**)
1. Select Android Version (**_Android 11_ recommended**)
2. Select items to install
#### Available Waydroid Extras:
- [GApps](https://github.com/opengapps/opengapps/wiki/FAQ) (Default Android applications including the **Google Play Store)** or [microG](https://microg.org/) (Free alternatives to Google applications)
- ARM Translation (*libndk* for **AMD CPUs only** & *libhoudini* for **Intel CPUs only**)
- ARM Translation (_libndk_ for **AMD CPUs only** & _libhoudini_ for **Intel CPUs only**)
- [Magisk](https://github.com/topjohnwu/Magisk) (Android power user suite)
@ -73,7 +81,6 @@ Selecting `Configure Waydroid` will allow users to install additional Android tw
![Waydroid_DeviceID|690x182](../img/Waydroid_DeviceID.png)
1. Launch Waydroid
(**Waydroid must be running**)
@ -84,6 +91,7 @@ Selecting `Configure Waydroid` will allow users to install additional Android tw
After verification has happened, it will usually take a while before your device is verified.
# Add as a Non-Steam Shortcut
> This is useful for [Bazzite images that use Steam Gaming Mode.](../Handheld_and_HTPC_edition/Steam_Gaming_Mode.md)
Make sure to add `/usr/bin/waydroid-launcher` to Steam as a non-Steam game for Waydroid to work properly in Steam Gaming Mode.

20
docs/src/Installing_and_Managing_Software/index.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=35", "fetched_at": "2024-09-03 16:43:05.697052+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -13,21 +18,19 @@
> 5. [AppImage](./AppImage.md) - Portable universal package format that relies on specific host libraries at a system-level, usually obtained from a project's website.
> 6. [`rpm-ostree`](./rpm-ostree.md) - Layer Fedora packages at a system-level (**not recommended, use as a last resort**)
# How do I run Windows applications?
> **Use a [WINE](https://www.winehq.org/) front-end**:
>
> * [Steam](https://store.steampowered.com/) (*pre-installed*) has a Windows compatibility layer built-in.
> * [Lutris](https://lutris.net/about) (*pre-installed*) for non-Steam video games.
> * [Heroic](https://heroicgameslauncher.com/) for Epic Games, GOG, and Amazon Games integration.
> * [Bottles](https://usebottles.com/) for general-purpose applications or as an alternative to Lutris.
> * [itch](https://flathub.org/apps/io.itch.itch) for games on itch.io.
> * [WineZGUI](https://github.com/fastrizwaan/WineZGUI) (*pre-installed*) for Windows applications that don’t require special considerations for their prefix.
> - [Steam](https://store.steampowered.com/) (_pre-installed_) has a Windows compatibility layer built-in.
> - [Lutris](https://lutris.net/about) (_pre-installed_) for non-Steam video games.
> - [Heroic](https://heroicgameslauncher.com/) for Epic Games, GOG, and Amazon Games integration.
> - [Bottles](https://usebottles.com/) for general-purpose applications or as an alternative to Lutris.
> - [itch](https://flathub.org/apps/io.itch.itch) for games on itch.io.
> - [WineZGUI](https://github.com/fastrizwaan/WineZGUI) (_pre-installed_) for Windows applications that don’t require special considerations for their prefix.
# How do I install Android applications?
Follow the [Waydroid Setup Guide](./Waydroid_Setup_Guide.md) to install Android applications on Bazzite.
> **Note**: Waydroid is **not supported** on other Universal Blue images like Aurora and Bluefin.
@ -37,7 +40,6 @@ Follow the [Waydroid Setup Guide](./Waydroid_Setup_Guide.md) to install Android
- [Plex Media Server](https://universal-blue.discourse.group/t/video-tutorial-how-to-install-plex-media-server-using-distrobox-on-bazzite/1999) (**Note**: Podman or Docker is recommended over Distrobox)
- [Flash Games](https://universal-blue.discourse.group/t/how-to-run-old-browser-games-with-web-apps/486)
<hr>
# Video Showcase of Installing Software

13
docs/src/Installing_and_Managing_Software/rpm-ostree.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2642", "fetched_at": "2024-09-03 16:43:05.295995+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -21,16 +26,19 @@ Install Fedora Linux packages by installing them with `rpm-ostree`.
```
rpm-ostree install <package>
```
Installs Fedora package(s) to the system that stay between updates.
```
rpm-ostree uninstall <package>
```
Uninstalls any layered packages added to the system.
```
rpm-ostree search <package>
```
Search for Fedora packages that can be installed.
# RPM packages installed on the host
@ -38,9 +46,11 @@ Search for Fedora packages that can be installed.
Fedora containers should be used for most RPM files, but sometimes they need to be installed to your host.
You can install RPM files **to your host** with `rpm-ostree` by entering:
```
rpm-ostree install <package>.rpm
```
You may need to copy the full path (`/path/to/rpmfile.rpm`) for it to install properly.
> **Note**: The downside of installing local RPM files outside of the Fedora repositories is updates for the specific RPM package will not apply automatically.
@ -64,6 +74,7 @@ There is also an experimental `copr` utility script that ships with Bazzite. Run
Layering packages are mostly intended for system-level applications, libraries, and other dependencies. It is recommend by upstream to use all of the methods above **before** installing software with `rpm-ostree`. Typical users should **not** be using `rpm-ostree` to install end-user graphical applications.
Layering packages can cause **severe consequences** including:
- Break upgrades or prevent rebasing.
- Conflict with existing packages as part of the image leading to dependency issues.
- Updates will take longer to download as you layer more packages to your system.
@ -74,6 +85,7 @@ It is **highly recommended** to only use this command when absolutely necessary
# How to remove **ALL** Layered Packages
If you run into issues upgrading due to a layered package conflict, then either optionally uninstall the conflicted package(s) or remove all layered packages with this **command**:
```bash
rpm-ostree reset
```
@ -94,5 +106,4 @@ https://coreos.github.io/rpm-ostree/
**See also**: https://universal-blue.discourse.group/docs?topic=513
[**<-- Back to Installing and Managing Software on Bazzite**](./index.md)

32
docs/src/Installing_and_Managing_Software/ujust.md
View File

@ -1,3 +1,8 @@
---
authors:
- "@nicknamenamenick"
---
<!-- ANCHOR: METADATA -->
<!--{"url_discourse": "https://universal-blue.discourse.group/docs?topic=2638", "fetched_at": "2024-09-03 16:43:04.643633+00:00"}-->
<!-- ANCHOR_END: METADATA -->
@ -14,7 +19,6 @@ Technically `ujust` is **not** a package format, but are convenience commands th
Open a host terminal and **enter**:
```
ujust
```
@ -45,21 +49,23 @@ You can search for specific commands by **entering**:
ujust | grep "<search keyword(s)>"
```
* `install-`: Install program, there is no configuration or uninstall commands at this time
* `get-`: Install an "extension" like Decky plugins, and if it is an extension then it can use `get-` too
* `setup-`: Install program, provides uninstall and configuration options for after install
* `configure-`: Configure something that came by default on the image
* If it must be installed first, then it will be in `setup-`
* `toggle-`: Turns something on/off
* Selection might be automatic or manual depending on implementation
* `fix-`: Fixes, patches or works around an issue
* `distrobox-`: Distrobox exclusive verb for useful Distrobox stuff
* `foo`: Replace this with whatever the command is called
* These are shortcuts that we have deemed necessary to not have a verb
* **Examples**: `ujust update` and `ujust enroll-secureboot-key`
- `install-`: Install program, there is no configuration or uninstall commands at this time
- `get-`: Install an "extension" like Decky plugins, and if it is an extension then it can use `get-` too
- `setup-`: Install program, provides uninstall and configuration options for after install
- `configure-`: Configure something that came by default on the image
- If it must be installed first, then it will be in `setup-`
- `toggle-`: Turns something on/off
- Selection might be automatic or manual depending on implementation
- `fix-`: Fixes, patches or works around an issue
- `distrobox-`: Distrobox exclusive verb for useful Distrobox stuff
- `foo`: Replace this with whatever the command is called
- These are shortcuts that we have deemed necessary to not have a verb
- **Examples**: `ujust update` and `ujust enroll-secureboot-key`
# View each `ujust` script's source code
If you would like to see what each script does for each command then open a host terminal and **enter**:
```
ujust --show <command>
```

2
docs/src/index.md
View File

@ -91,7 +91,7 @@ A quick list of stuff you might be interested in checking out:
[rpm-ostree]: Installing_and_Managing_Software/rpm-ostree.md
[distrobox]: Installing_and_Managing_Software/Distrobox.md
[installing_software]: Installing_and_Managing_Software/index.md
[contrib]: General/Contributing_to_Bazzite.md
[contrib]: Advanced/Contributing_to_bazzite.md
[homebrew]: Installing_and_Managing_Software/Homebrew.md
[rpm-ostree_caveats]: Installing_and_Managing_Software/rpm-ostree.md#major-caveats-using-rpm-ostree
[steam_game_mode]: Handheld_and_HTPC_edition/Steam_Gaming_Mode.md#what-is-steam-gaming-mode

7
docs/src/stylesheets/bazzite.css
View File

@ -89,6 +89,13 @@ nav.md-nav {
}
}
/* Authors list */
.authors-list, .authors-list .authors-chip {
display: inline-flex;
align-items: center;
gap: 0.3rem;
}
/* Mobile tweaks */
@media screen and (max-width: 59.9844em) {
.md-nav__source {

25
docs/theme_overrides/main.html
View File

@ -1,6 +1,25 @@
{% extends "base.html" %}
{% block announce %}
<span class="twemoji">⚠️</span>
Welcome to the new home for Bazzite documentation!
<!-- TODO: replace with eiher git-committers or a better looking template -->
{% block content %}
{% if page.meta.authors %}
<small class="authors-list">
Authors:
<nav>
{% for author in page.meta.authors %}
{% if "@" in author %}
{% set author = author[1:] %}
<a href="https://github.com/{{author}}" class="author-chip" title="@{{author}}"
style="display: inline-flex; align-items: center; gap: 0.3rem;">
<img class="md-author" src="https://github.com/{{author}}.png?size=40">
{{author}}
</a>
{% else %}
<span title="{{author}}">{{author}}</span>
{% endif %}
{% endfor %}
</nav>
</small>
{% endif %}
{{ super() }}
{% endblock %}

3
docs/utils/install-deps.sh
View File

@ -16,6 +16,9 @@ if ! command -v just >/dev/null; then
echod "Installing just"
brew install just
fi
if ! command -v just >/dev/null; then
brew install prettier
fi
# Install poetry project
echod "Setting up poetry project"