From e47acf56df3bb0e9cb193a17d19b465b9d237a11 Mon Sep 17 00:00:00 2001 From: Michał Smyk Date: Apr 29 2025 18:48:32 +0000 Subject: Updated Steam installation documentation - added troubleshooting section and updated Steam Proton configuration screenshot --- diff --git a/modules/ROOT/assets/images/steam_play.png b/modules/ROOT/assets/images/steam_play.png index 61ca8f6..74a41a9 100644 Binary files a/modules/ROOT/assets/images/steam_play.png and b/modules/ROOT/assets/images/steam_play.png differ diff --git a/modules/ROOT/pages/game-installation.adoc b/modules/ROOT/pages/game-installation.adoc index 3e9b7a5..fc8c1fd 100644 --- a/modules/ROOT/pages/game-installation.adoc +++ b/modules/ROOT/pages/game-installation.adoc @@ -1,9 +1,5 @@ = Game Installation -IMPORTANT: With Fedora 38 their is an issue where Steam installed from Flathub -will not start. This issue is being tracked on the -https://discussion.fedoraproject.org/t/steam-from-flathub-might-not-start-on-fedora-38/80839[Fedora Discussion] page - NOTE: Fedora does not support some of these platforms out of the box due to current policies, thus requiring some additional steps to use. The most common need is setting up RPM-Fusion repository as instructed diff --git a/modules/ROOT/pages/proton.adoc b/modules/ROOT/pages/proton.adoc index 016732c..1eb4eab 100644 --- a/modules/ROOT/pages/proton.adoc +++ b/modules/ROOT/pages/proton.adoc @@ -1,9 +1,5 @@ = Steam Installation -IMPORTANT: With Fedora 38 there is an issue where Steam installed from Flathub -will not start. This issue is being tracked on the -https://discussion.fedoraproject.org/t/steam-from-flathub-might-not-start-on-fedora-38/80839[Fedora Discussion] page - NOTE: This will require enabling an external repository. NOTE: If you enabled "Third Party Software" (`rpmfusion Nonfree`) at installation you can skip to installing Steam. @@ -12,7 +8,7 @@ NOTE: If you enabled "Third Party Software" (`rpmfusion Nonfree`) at installatio == Using the terminal -=== enabling The external repository (`rpmfusion Nonfree`) +=== Enabling the external repository (`rpmfusion Nonfree`) * Launch The terminal prompt of your choice @@ -25,15 +21,17 @@ sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-releas [source,bash] ---- -sudo dnf config-manager --enable fedora-cisco-openh264 -y +sudo dnf config-manager setopt fedora-cisco-openh264.enabled=1 ---- -For Fedora 41: + +For older versions (Fedora 40 and lower): + [source,bash] ---- -sudo dnf config-manager setopt fedora-cisco-openh264.enabled=1 +sudo dnf config-manager --enable fedora-cisco-openh264 -y ---- -=== installing Steam +=== Installing Steam * Run the following command with a user that has root acess or can use the `sudo` command @@ -48,7 +46,7 @@ Open Software under the Activities in the top left corner. image::software.png[Software, 800, 600] -=== enabling The external repository (`rpmfusion Nonfree`) +=== Enabling the external repository (`rpmfusion Nonfree`) * Click the Menu Button (☰) on upper right corner and choose Software Repositories. (Circled red for visual aide) @@ -65,7 +63,9 @@ image::repos.png[800, 600] image::search.png[800, 600] -=== installing Steam +=== Installing Steam + +NOTE: Following installation requires you to be online. * Search for Steam and install it. @@ -73,7 +73,22 @@ image::steam.png[800, 600] * Launch Steam. -NOTE: Following installation requires you to be online. +=== Troubleshooting === + +==== Steam does not start after initial installation + +In case you are not able to run Steam application after initial installation, please try running it from terminal via following command: + +[source,bash] +---- +__GL_CONSTANT_FRAME_RATE_HINT=3 steam +---- + +==== Flathub installation + +IMPORTANT: With Fedora 38 there is an issue where Steam installed from Flathub +will not start. This issue is being tracked on the +https://discussion.fedoraproject.org/t/steam-from-flathub-might-not-start-on-fedora-38/80839[Fedora Discussion] page == Enable Proton engine @@ -83,7 +98,7 @@ NOTE: Following installation requires you to be online. image::settings.png[800, 600] -* Click Steam Play. +* Click Compatibility. * Check Enable Steam Play for supported titles. * Check Enable Steam Play for all other titles and select the Proton version you installed. * Press OK @@ -94,7 +109,6 @@ image::steam_play.png[800, 600] Once Steam restarts all games in your Steam Library should be available to install and play. - === Next steps === Install available title from the Library menu and play it. diff --git a/site.yml b/site.yml index 76f34fe..d552ba1 100644 --- a/site.yml +++ b/site.yml @@ -16,5 +16,5 @@ output: destinations: - provider: archive runtime: - pull: true + fetch: true cache_dir: ./cache