Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add First Run section #179

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion modules/ROOT/pages/faq.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,14 @@ However, {variant-name} is specifically focused on workstation and desktop use c

== About using {variant-name}

[[how-can-i-play-more-videos-in-firefox-like-youtube]]
=== How can I play more videos in Firefox, like YouTube?

Firefox is included in the OS image for now (see https://github.com/fedora-silverblue/issue-tracker/issues/288[issue#288] for progress on moving to Flatpak by default).
Until that changes, getting it to play videos works the same way as it does for the regular {variant-classic}: find a package with the needed codecs, and install it.
The one difference is that you use `rpm-ostree install` instead of `dnf install`.
An alternative solution is to install https://flathub.org/apps/details/org.mozilla.firefox[Firefox from Flathub].

An alternative solution is xref:tips-and-tricks.adoc#_hiding-the-default-browser-firefox[hiding the default browser] and install https://flathub.org/apps/details/org.mozilla.firefox[Firefox from Flathub]

=== How do I create a VPN connection?

Expand Down
2 changes: 1 addition & 1 deletion modules/ROOT/pages/installation.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -98,4 +98,4 @@ Depending on different personal needs, there are several starting actions and in
If you are new to {variant-name} and before installing software in your newly installed Fedora, you should read the https://docs.fedoraproject.org/en-US/fedora-silverblue/getting-started/[Getting Started] section to learn about the difference between *Flatpak*, *Toolbox* and *package layering* (rpm-ostree).
====

For some tips about of {variant-name} see the xref:tips-and-tricks.adoc[Tips and Tricks] section
For some tips about basic customization of {variant-name} see the xref:tips-and-tricks.adoc#_basic-customization[Basic Customization] section
88 changes: 88 additions & 0 deletions modules/ROOT/pages/tips-and-tricks.adoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
= Tips and Tricks

[[hiding-the-default-browser-firefox]]
== Hiding the default browser (Firefox)

If you're using another browser than the one installed by default (Firefox) then you can hide the default one from the interface via the following commands:
Expand All @@ -18,6 +19,7 @@ $ sudo sed -i "2a\\NotShowIn=GNOME;KDE" /usr/local/share/applications/org.mozill
$ sudo update-desktop-database /usr/local/share/applications/
```

[[enabling_rpm_fusion_repos]]
== Enabling RPM Fusion repos

[CAUTION]
Expand Down Expand Up @@ -167,3 +169,89 @@ or setup shell `alias`es as needed to make them available to the CLI like so:
$ alias evince="flatpak run org.gnome.Evince"
# or alias evince="org.gnome.Evince"
$ evince

[[basic-customization]]
== Basic Customization

* Enable RPM Fusion: see the xref:tips-and-tricks.adoc#_enabling_rpm_fusion_repos[Enabling RPM Fusion repos] section
* Enable TRIM in encrypt installation: see the xref:tips-and-tricks.adoc#_enabling-trim-in-encrypt-installation[Enabling TRIM in encrypt installation] section
* Enable Intel GPU Acceleration: see the xref:tips-and-tricks.adoc#_enabling-intel-gpu-acceleration[Enabling Intel GPU Acceleration] section
* Using NVIDIA drivers: see the xref:troubleshooting.adoc#_using_nvidia_drivers[Using NVIDIA drivers] section
* Install GNOME Tweaks: run the command

$ rpm-ostree install gnome-tweak-tool

* Install Extension Manager: run the command

$ flatpak install flathub org.gnome.Extensions

* Install ffmpeg codecs: run the command

$ flatpak install org.freedesktop.Platform.ffmpeg-full

* Play more videos in Firefox: see xref:faq.adoc#_how-can-i-play-more-videos-in-firefox-like-youtube[How can I play more videos in Firefox, like YouTube?] section

[[enabling-intel-gpu-acceleration]]
== Enabling Intel GPU Acceleration

Starting with Gen9 microarchitecture (Skylake), Intel GPUs include a Graphics micro Controller (GuC).

As explained from this https://cdrdv2-public.intel.com/793432/793432_Intel_Core_Ultra_Datasheet_Rev001.pdf[document in PDF format provided by Intel] there are power, performance and functionalities benefits from Gen9 (Skylake) GPUs and later, using the new GuC and HuC firmware.

[IMPORTANT]
====
Before installing Intel firmware, be sure to enable the RPM Fusion. See the xref:tips-and-tricks.adoc#_enabling_rpm_fusion_repos[Enabling RPM Fusion repos] section
====

To install the Intel firmwares run the command:

$ rpm-ostree override remove mesa-va-drivers \
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll have to link to the entry about RPM Fusion before those commands

--install mesa-va-drivers-freeworld \
--install intel-media-driver \

After installing Intel drivers, the firmwares are enabled by default for Gen11+ microarchitecture GPUs, for previous generation GPUs you can enable the firmwares with the command:

`$ rpm-ostree kargs --append=i915.enable_guc=2` +
for Gen9 microarchitecture: Skylake microprocessors

`$ rpm-ostree kargs --append=i915.enable_guc=3` +
for Gen9.5 microarchitecture: Kaby Lake, Coffee Lake, Comet Lake, and Goldmont Plus based microprocessors

[TIP]
====
`rpm-ostree kargs` means Modifying Kernel Arguments. To understand and learn more about the _kargs_ option see: https://docs.fedoraproject.org/en-US/fedora-coreos/kernel-args/
====

To check that the GuC and HuC firmwares are active on your Fedora Silverblue system, you can run the commands:

$ dmesg | grep "GuC"

$ dmesg | grep "HuC"

For more information about Intel GPUs Hardware acceleration in Linux see:

* https://fedoraproject.org/wiki/Firefox_Hardware_acceleration#Configure_VA-API_Video_decoding_on_Intel[VA-API Video decoding on Fedora Project wiki]
* https://github.com/intel/media-driver[The Intel(R) Media Driver for VAAPI Github]
* This topic on Fedora Discussion: https://discussion.fedoraproject.org/t/intel-graphics-best-practices-and-settings-for-hardware-acceleration/69944/44

[[enabling-trim-in-encrypt-installation]]
== Enabling TRIM in encrypt installation

If a fedora installation is performed using the disk encryption option, TRIM is not enabled by default.
This happens because although TRIM increases the performance of your SSD, it results in a loss of security in disk encryption.
At https://asalor.blogspot.com/2011/08/trim-dm-crypt-problems.html[this blog article] you can read the analysis of a cryptsetup developer. +
_If you consider the use of TRIM to be more important to you than security you can go ahead and enable it._

* Locates the luks partition where TRIM is not active:

$ lsblk --discard

* Enable TRIM (where _luks-xxx_ is your luks found with the previous command)

$ sudo cryptsetup --allow-discards --persistent refresh luks-xxx

* Verify that your partition has the _allow_discards_ flag with the command:

$ sudo dmsetup table

For further help see this topic in Fedora Discussion: https://discussion.fedoraproject.org/t/trim-for-ssd/82876
1 change: 1 addition & 0 deletions modules/ROOT/pages/troubleshooting.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ A partial https://github.com/projectatomic/rpm-ostree/pull/1795[solution] has be

This issue is tracked in https://github.com/coreos/rpm-ostree/issues/233[rpm-ostree#233].

[[using-nvidia-drivers]]
== Using NVIDIA drivers

You can install the official NVIDIA binary drivers from the RPM Fusion repositories.
Expand Down