Skip to content

docs: add troubleshooting entry for games #345

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.

Sign up for GitHub

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

Merged
RoyalOughtness merged 1 commit into from
Apr 15, 2026
+7 −1
Merged

docs: add troubleshooting entry for games #345

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
8 changes: 7 additions & 1 deletion content/FAQ.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ permalink: /faq
- [My fans are really loud, is this normal?](#fans)
- [On secureblue half of my CPU cores are gone. Why is this?](#smt)
- [Why don't my AppImages work?](#appimage)
- [Why don't my games/mods/mod managers work?](#anticheat-troubleshoot)
- [Why won't Trivalent start when Bubblejailed?](#trivalent-bubblejail)
- [Why won't Trivalent start on Nvidia?](#trivalent-nvidia)
- [Why doesn't/won't/can't Trivalent...?](#trivalent-faq)
Expand Down Expand Up @@ -268,7 +269,7 @@ ujust install-steam
### [How do I enable anti-cheat support?](#anticheat)
{: #anticheat}

{% include alert.html type='note' content='Kernel-level anti-cheat solutions are generally unsupported on desktop Linux.' %}
{% include alert.html type='note' content='Kernel-level anti-cheat solutions are generally unsupported on desktop Linux. You may want to search [Are We Anti-Cheat Yet](https://areweanticheatyet.com) if a game doesn't work.' %}

Anti-cheat solutions typically require process tracing to work - the ability to monitor syscalls (and other signals) from other processes. On Linux, process tracing is controlled by the `kernel.yama.ptrace_scope` kernel parameter. [By default, secureblue doesn't allow ptrace attachment](https://github.com/secureblue/secureblue/blob/live/files/system/etc/sysctl.d/61-ptrace-scope.conf) at all, addressing [basic security concerns](https://www.kernel.org/doc/html/latest/admin-guide/LSM/Yama.html). The command below toggles between this restrictive default setting where `ptrace_scope` is set to `3`, breaking anti-cheat software, and a much less restrictive setting where `ptrace_scope` is set to `1`, which allows parent processes to trace child processes, enabling some anti-cheat solutions to work.

Expand Down Expand Up @@ -528,6 +529,11 @@ If SMT is disabled, this effectively halves the number of CPU cores; the perform

AppImages depend on fuse2, which is unmaintained and depends on a SUID root binary. For this reason, fuse2 support is removed by default. It's strongly recommended that you find alternative mechanisms to install your applications (Flatpak, Distrobox, etc.). If you can't find an alternative and still need fuse2, you can add it back by layering with `rpm-ostree install fuse` and then rebooting.

### [Why don't my games/mods/mod managers work?](#anticheat-troubleshoot)
{: #anticheat-troubleshoot}

Some modding systems and anti-cheat solutions require process tracing to work, which is disabled by default on secureblue. For more information, see: [How do I enable anti-cheat support?](#anticheat)

### [Why won't Trivalent start when Bubblejailed?](#trivalent-bubblejail)
{: #trivalent-bubblejail}

Expand Down