From cabdf39d06a1ff29a0d712a7242846317a3533b4 Mon Sep 17 00:00:00 2001 From: Sten Tijhuis <102481635+Stensel8@users.noreply.github.com> Date: Thu, 26 Feb 2026 23:12:02 +0100 Subject: [PATCH] docs: update asusctl to 6.3.4, clarify suite architecture, fix image refs - Bump asusctl and rog-control-center to 6.3.4 - Clarify architecture: asusd (backend daemon), asusctl (CLI frontend), - Replace lone "Luke Jones" mentions with "asus-linux team"; link to releases page at gitlab.com/asus-linux/asusctl/-/releases - Fix broken image reference: High-Tide.avif -> high-tide.avif (case sensitivity on Linux) - Add missing untracked images that were already referenced in content --- content/_index.md | 4 +- content/_index.nl.md | 4 +- content/docs/_index.md | 2 +- content/docs/_index.nl.md | 2 +- content/docs/applications.md | 181 +++++++++++++----- content/docs/applications.nl.md | 179 ++++++++++++----- content/docs/getting-started.md | 25 +-- content/docs/getting-started.nl.md | 25 +-- content/docs/hardware/_index.md | 2 +- content/docs/hardware/_index.nl.md | 2 +- content/docs/hardware/asusctl-rog-control.md | 39 ++-- .../docs/hardware/asusctl-rog-control.nl.md | 39 ++-- .../hardware/nvidia-driver-installation.md | 15 +- .../hardware/nvidia-driver-installation.nl.md | 15 +- content/docs/hardware/secure-boot.md | 38 ++-- content/docs/hardware/secure-boot.nl.md | 38 ++-- content/docs/known-issues.md | 37 ++-- content/docs/known-issues.nl.md | 37 ++-- content/docs/networking/_index.md | 2 +- content/docs/networking/_index.nl.md | 2 +- .../eduroam-network-installation.md | 10 +- .../eduroam-network-installation.nl.md | 10 +- content/docs/security/_index.md | 2 +- content/docs/security/_index.nl.md | 2 +- content/docs/security/autologin.md | 5 +- content/docs/security/autologin.nl.md | 5 +- content/docs/security/yubikey.md | 23 +-- content/docs/security/yubikey.nl.md | 23 +-- content/docs/virtualization/_index.md | 2 +- content/docs/virtualization/_index.nl.md | 2 +- .../virtualization/looking-glass-attempt.md | 43 +++-- .../looking-glass-attempt.nl.md | 43 +++-- content/docs/virtualization/vm-setup.md | 19 +- content/docs/virtualization/vm-setup.nl.md | 19 +- hugo.toml | 2 +- static/images/high-tide.avif | Bin 0 -> 170617 bytes static/images/libreoffice-bibliograpy.avif | Bin 0 -> 54894 bytes .../libreoffice-inserting_references.avif | Bin 0 -> 37657 bytes .../only-office-missing_references.avif | Bin 0 -> 30877 bytes static/images/only-office.avif | Bin 0 -> 30442 bytes static/images/steam-gnome-software.avif | Bin 75593 -> 0 bytes static/images/steam-website.avif | Bin 0 -> 128724 bytes static/scripts/saxion-eduroam.py | 15 +- 43 files changed, 556 insertions(+), 357 deletions(-) create mode 100644 static/images/high-tide.avif create mode 100644 static/images/libreoffice-bibliograpy.avif create mode 100644 static/images/libreoffice-inserting_references.avif create mode 100644 static/images/only-office-missing_references.avif create mode 100644 static/images/only-office.avif delete mode 100644 static/images/steam-gnome-software.avif create mode 100644 static/images/steam-website.avif diff --git a/content/_index.md b/content/_index.md index 9628891..94557db 100644 --- a/content/_index.md +++ b/content/_index.md @@ -25,7 +25,7 @@ toc: false
{{< callout type="info" >}} -**Personal documentation.** I'm not a developer or Linux expert — just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Running kernel 6.19.3-2 on CachyOS (Arch). +**Personal documentation.** I'm not a developer or Linux expert, just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Running kernel 6.19.3-2 on CachyOS (Arch). {{< /callout >}} ## Current System Configuration @@ -66,7 +66,7 @@ toc: false >}} {{< hextra/feature-card title="Secure Boot" - subtitle="Custom signing keys with sbctl, HSI:3 to HSI:4" + subtitle="Custom signing keys with sbctl, UEFI Secure Boot enabled" icon="shield-check" link="docs/hardware/secure-boot" >}} diff --git a/content/_index.nl.md b/content/_index.nl.md index 439b2ed..6c5ed7b 100644 --- a/content/_index.nl.md +++ b/content/_index.nl.md @@ -25,7 +25,7 @@ toc: false
{{< callout type="info" >}} -**Persoonlijke documentatie.** Ik ben geen developer of Linux-expert — gewoon iemand die overgestapt is naar Linux op deze laptop en dingen uitzoekend onderweg. Ik deel wat werkte zodat anderen niet helemaal opnieuw hoeven te beginnen. Alles is op eigen risico. Kom je ergens niet uit, laat het gerust weten — ik denk graag mee. Draait kernel 6.19.3-2 op CachyOS (Arch). +**Persoonlijke documentatie.** Ik ben geen developer of Linux-expert, gewoon iemand die overgestapt is naar Linux op deze laptop en dingen uitzoekend onderweg. Ik deel wat werkte zodat anderen niet helemaal opnieuw hoeven te beginnen. Alles is op eigen risico. Kom je ergens niet uit, laat het gerust weten; ik denk graag mee. Draait kernel 6.19.3-2 op CachyOS (Arch). {{< /callout >}} ## Huidige Systeemconfiguratie @@ -66,7 +66,7 @@ toc: false >}} {{< hextra/feature-card title="Secure Boot" - subtitle="Aangepaste ondertekeningssleutels met sbctl, HSI:3 naar HSI:4" + subtitle="Aangepaste ondertekeningssleutels met sbctl, UEFI Secure Boot ingeschakeld" icon="shield-check" link="docs/hardware/secure-boot" >}} diff --git a/content/docs/_index.md b/content/docs/_index.md index 8ada615..c64199e 100644 --- a/content/docs/_index.md +++ b/content/docs/_index.md @@ -30,7 +30,7 @@ Everything I've documented while running CachyOS on the ROG Zephyrus G16. Start >}} {{< hextra/feature-card title="Secure Boot" - subtitle="Custom signing keys with sbctl, HSI:3 to HSI:4" + subtitle="Custom signing keys with sbctl, UEFI Secure Boot enabled" icon="shield-check" link="hardware/secure-boot" >}} diff --git a/content/docs/_index.nl.md b/content/docs/_index.nl.md index f4e537c..0e65a44 100644 --- a/content/docs/_index.nl.md +++ b/content/docs/_index.nl.md @@ -30,7 +30,7 @@ Alles wat ik heb opgeschreven tijdens het draaien van CachyOS op de ROG Zephyrus >}} {{< hextra/feature-card title="Secure Boot" - subtitle="Aangepaste ondertekeningssleutels met sbctl, HSI:3 naar HSI:4" + subtitle="Aangepaste ondertekeningssleutels met sbctl, UEFI Secure Boot ingeschakeld" icon="shield-check" link="hardware/secure-boot" >}} diff --git a/content/docs/applications.md b/content/docs/applications.md index af0d272..9f576c8 100644 --- a/content/docs/applications.md +++ b/content/docs/applications.md @@ -1,6 +1,8 @@ --- title: "Applications" -weight: 25 +weight: 4 +prev: docs/security/yubikey +next: docs/networking/eduroam-network-installation --- Everything I installed after the initial CachyOS setup. Organized loosely by category. Most of this is personal preference, but the Brave and libinput-config sections include non-obvious workarounds that aren't documented elsewhere. @@ -9,33 +11,33 @@ Everything I installed after the initial CachyOS setup. Organized loosely by cat On CachyOS there are three places to get software from. When looking for an application, check them in this order: -1. **[CachyOS packages](https://packages.cachyos.org/)** — CachyOS's own repository, built on top of Arch. Packages here are optimized for modern CPUs (x86-64-v3/v4) and include CachyOS-specific patches. Install with `sudo pacman -S `. +1. **[CachyOS packages](https://packages.cachyos.org/)**: CachyOS's own repository, built on top of Arch. Packages here are optimized for modern CPUs (x86-64-v3/v4) and include CachyOS-specific patches. Install with `sudo pacman -S `. -2. **[AUR](https://aur.archlinux.org/)** (Arch User Repository) — community-maintained build scripts for software not in the official repos. Install with an AUR helper like `paru -S `. Quality varies per package but the AUR covers almost everything. +2. **[AUR](https://aur.archlinux.org/)** (Arch User Repository): community-maintained build scripts for software not in the official repos. Install with an AUR helper like `paru -S `. Quality varies per package but the AUR covers almost everything. -3. **[Flathub](https://flathub.org/)** — Flatpak packages that bundle all their own dependencies. Install with `flatpak install flathub `, run with `flatpak run `. +3. **[Flathub](https://flathub.org/)**: Flatpak packages that bundle all their own dependencies. Install with `flatpak install flathub `, run with `flatpak run `. -**Native (pacman/paru) vs Flatpak — which to choose?** +**Native (pacman/paru) vs Flatpak: which to choose?** | | Native (pacman/paru) | Flatpak | |---|---|---| -| **Performance** | Better — uses shared system libraries | Slightly worse — bundles own libraries | -| **Integration** | Tight — full system access | Sandboxed — more isolated | +| **Performance** | Better (uses shared system libraries) | Slightly worse (bundles own libraries) | +| **Integration** | Tight (full system access) | Sandboxed (more isolated) | | **Size** | Smaller | Larger | | **Compatibility** | Depends on distro | Consistent across distros | | **Security** | Standard | Better sandboxing | -Native packages offer better performance and system integration. Flatpaks trade some efficiency for compatibility and sandboxing. The choice is yours per application — both work fine on CachyOS. +Native packages offer better performance and system integration. Flatpaks trade some efficiency for compatibility and sandboxing. The choice is yours per application; both work fine on CachyOS. ## Initial System Setup ### Set the hostname -Nothing special — just set the hostname via System Settings so the machine has a proper name on the network. +Nothing special here, just set the hostname via System Settings so the machine has a proper name on the network. ![Set hostname](/images/system-info.avif) -### GNOME window buttons — adding minimize & maximize back +### GNOME window buttons: adding minimize & maximize back By default, GNOME 49 only shows the close button. One command fixes it: @@ -45,7 +47,7 @@ gsettings set org.gnome.desktop.wm.preferences button-layout 'appmenu:minimize,m ![Example of how the new GNOME windows look](/images/window-controls.avif) -### GNOME keyboard shortcuts — making it feel more like Windows +### GNOME keyboard shortcuts: making it feel more like Windows Coming from Windows, some things feel off without the right shortcuts. These are the ones I set up to make the transition smoother. @@ -65,9 +67,9 @@ Coming from Windows, some things feel off without the right shortcuts. These are | 5 | Open file manager | `nautilus` | `Super+E` | | 6 | Emoji picker | `flatpak run it.mijorus.smile` | Copilot key | -GNOME doesn't have built-in shortcuts for the file manager or an emoji picker, so these need to be created manually. See [Smile](#smile--emoji-picker) for how the Copilot key is used. +GNOME doesn't have built-in shortcuts for the file manager or an emoji picker, so these need to be created manually. See [Smile](#smile-emoji-picker) for how the Copilot key is used. -### GNOME window focus — apps opening in the background +### GNOME window focus: apps opening in the background Apps like Signal and Discord sometimes open in the background, showing a "Your app is ready" notification instead of bringing the window to the front. Fix this with: @@ -75,9 +77,9 @@ Apps like Signal and Discord sometimes open in the background, showing a "Your a gsettings set org.gnome.desktop.wm.preferences focus-new-windows 'smart' ``` -The default `strict` mode never focuses new windows automatically. `smart` lets GNOME decide — in practice this means newly launched apps come to the foreground as expected. +The default `strict` mode never focuses new windows automatically. `smart` lets GNOME decide; in practice this means newly launched apps come to the foreground as expected. -### Touchpad scroll speed — no native GNOME setting (yet) +### Touchpad scroll speed: no native GNOME setting (yet) As of GNOME 49, there is simply **no native setting** for touchpad scroll speed anywhere in the Settings panel. KDE Plasma has had this for years. There are merge requests open in [mutter](https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1840) and [GNOME Control Center](https://gitlab.gnome.org/GNOME/gnome-control-center/-/merge_requests/991) to add it, but they've been sitting there for years. See the [GNOME Discourse thread](https://discourse.gnome.org/t/adding-scroll-speed-setting-in-gnome/25893) for context. @@ -135,14 +137,14 @@ sudo rm /etc/libinput.conf ### Brave -I use Brave as my main browser. I started with the Flatpak version but switched to the native package — it integrates better with the system and offers better performance. +I use Brave as my main browser. I started with the Flatpak version but switched to the native package, which integrates better with the system and offers better performance. - **Native (pacman):** Better system integration, better performance. This is what I use. - **Flatpak:** Might work better in some situations, but feels a bit more isolated. **Installation** -[brave-bin on CachyOS packages](https://packages.cachyos.org/package/cachyos/x86_64/brave-bin) — available directly in the CachyOS repo, no AUR helper needed. +[brave-bin on CachyOS packages](https://packages.cachyos.org/package/cachyos/x86_64/brave-bin): available directly in the CachyOS repo, no AUR helper needed. ```bash sudo pacman -S brave-bin @@ -150,7 +152,7 @@ sudo pacman -S brave-bin ![Brave official Linux install instructions](/images/brave-linux-install.avif) -Hardware acceleration works fine with current Brave and kernel versions. The crash bugs that affected Brave 1.82–1.86 are resolved — see [Known Issues]({{< relref "/docs/known-issues" >}}) for the history. +Hardware acceleration works fine with current Brave and kernel versions. The crash bugs that affected Brave 1.82–1.86 are resolved. See [Known Issues]({{< relref "/docs/known-issues" >}}) for the history. **Flatpak alternative** @@ -173,16 +175,82 @@ Password manager. Available via Flathub and works well. ### Signal Messenger -Signal is my main messaging app. Officially only supported on Debian/Ubuntu, but the Flatpak version works fine on CachyOS. +Signal is my main messaging app. The [CachyOS extra repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) ships a native package, which is what I use and it works better than the Flatpak. + +**CachyOS / Arch (recommended):** + +```bash +sudo pacman -S signal-desktop +``` + +**Flatpak (alternative):** + +```bash +flatpak install flathub org.signal.Signal +``` ![Signal Messenger app in Flathub](/images/signal-flathub.avif) ### Proton Mail -Proton Mail desktop app is a wrapper around the web app rather than a native client. Works fine and shows up in the app launcher like any other app. +Proton Mail desktop app is a wrapper around the web app rather than a native client. The [CachyOS repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) ships `proton-mail-bin`, which integrates more natively into the desktop than the Flatpak: better tray icon behavior, system notifications, and no Flatpak sandbox overhead. + +**CachyOS / Arch (recommended):** + +```bash +sudo pacman -S proton-mail-bin +``` + +**Flatpak (alternative):** + +```bash +flatpak install flathub me.proton.Mail +``` ![Proton Mail app in Flathub](/images/protonmail-flathub.avif) +### Office suites + +No official Microsoft 365 client exists for Linux. Two solid alternatives cover most use cases. + +#### OnlyOffice + +[OnlyOffice](https://packages.cachyos.org/package/cachyos/x86_64/onlyoffice-bin) is the closest thing to Microsoft 365 on Linux. The UI is nearly identical, with Word, Excel, and PowerPoint equivalents that look and behave like the Microsoft originals. Good compatibility with `.docx`, `.xlsx`, and `.pptx` files. + +```bash +sudo pacman -S onlyoffice-bin +``` + +![OnlyOffice running on GNOME](/images/only-office.avif) + +**Missing: APA-style references** + +One notable gap for academic work: OnlyOffice has no built-in citation manager or APA reference style support out of the box. + +![OnlyOffice - references feature missing](/images/only-office-missing_references.avif) + +There are workarounds via plugins. The [OnlyOffice help center documents reference management](https://helpcenter.onlyoffice.com/docs/userguides/plugins/InsertReferences.aspx) through integrations like Zotero or Mendeley, both citation managers that can hook into the editor. I haven't set this up myself yet, so I can't assess how well it actually works in practice. + +#### LibreOffice + +[LibreOffice Fresh](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/libreoffice-fresh) is the most actively developed open-source office suite and the most Linux-native option. More development effort goes into it than any alternative. + +```bash +sudo pacman -S libreoffice-fresh +``` + +**APA references: built in** + +Unlike OnlyOffice, LibreOffice has a built-in bibliography database and reference insertion. You can manage your sources and insert citations in APA format directly from the menus: + +![LibreOffice bibliography manager](/images/libreoffice-bibliograpy.avif) + +![LibreOffice - inserting references](/images/libreoffice-inserting_references.avif) + +**Caveat: Microsoft format compatibility** + +LibreOffice can open and save `.docx`/`.xlsx`/`.pptx` files, but there are known rendering differences with documents created in Microsoft Word. This comes down to how Microsoft and LibreOffice have each implemented the OpenXML standard, not always identically. For documents that stay within LibreOffice's own ODF format, there are no issues. + --- ## Development @@ -195,19 +263,23 @@ sudo pacman -S git github-cli ### Visual Studio Code +Two builds are available. The **Microsoft build** includes the full Microsoft extension marketplace and proprietary extensions like GitHub Copilot. The **open-source build** (`code`) removes Microsoft telemetry and branding, but proprietary extensions are not available. + +**Microsoft build (recommended, full extension support):** + ```bash -sudo pacman -S code +paru -S visual-studio-code-bin ``` -{{< callout type="warning" >}} -On kernel 6.18.x/6.19.x, VS Code hardware acceleration can trigger an amdgpu page fault causing a full system freeze. Disable hardware acceleration by adding to `~/.config/Code/User/settings.json`: -```json -{ - "disable-hardware-acceleration": true -} +Available in the [AUR](https://aur.archlinux.org/packages/visual-studio-code-bin). + +**Open-source build (no Microsoft telemetry):** + +```bash +sudo pacman -S code ``` -See [Known Issues]({{< relref "/docs/known-issues" >}}) for details. -{{< /callout >}} + +Available in the [CachyOS extra repository](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/code). ### Kleopatra & GPG commit signing @@ -232,13 +304,13 @@ Use the ID from the `sec` line (e.g., `rsa4096/YOUR_GPG_KEY_ID`). ### Archi (ArchiMate modeling tool) -[Archi](https://www.archimatetool.com/) is a free ArchiMate modeling tool. The Linux package is a portable archive — no installer. To make it show up in GNOME with an icon, you have to place the files yourself and create a desktop entry manually. +[Archi](https://www.archimatetool.com/) is a free ArchiMate modeling tool. The Linux package is a portable archive with no installer. To make it show up in GNOME with an icon, you have to place the files yourself and create a desktop entry manually. {{< callout type="info" >}} Archi's download page warns about possible UI issues on Wayland. In my experience it runs fine on GNOME 49 Wayland. {{< /callout >}} -![Archi download page — Linux version with Wayland note](/images/archi-download.avif) +![Archi download page - Linux version with Wayland note](/images/archi-download.avif) ```bash # Download and extract @@ -286,26 +358,33 @@ After saving, Archi appears in the GNOME app launcher: ### Steam -On CachyOS, Steam is available directly from the `multilib` repository — no extra repos needed. +On CachyOS, Steam is available directly from the [CachyOS repository](https://packages.cachyos.org/package/cachyos/x86_64/steam), no extra repos needed. ```bash sudo pacman -S steam ``` -![Steam in GNOME Software](/images/steam-gnome-software.avif) +![Steam in GNOME Software](/images/steam-website.avif) Reboot after installing. Steam includes Proton out of the box for running Windows games on Linux. -{{< callout type="info" >}} -If Steam won't launch, try running it from the terminal with: +### Tidal + +There's no official Tidal client for Linux. Two community alternatives exist. + +#### High Tide (recommended) + +[High Tide](https://aur.archlinux.org/packages/high-tide) is a native GTK4 frontend for Tidal, not an Electron wrapper, but an actual application built with proper Linux toolkit. It looks clean, integrates well with GNOME, and supports Hi-Fi quality. + ```bash -__GL_CONSTANT_FRAME_RATE_HINT=3 steam +paru -S high-tide ``` -{{< /callout >}} -### Tidal Hi-Fi +![High Tide running on GNOME](/images/high-tide.avif) + +#### Tidal Hi-Fi -There's no official Tidal client for Linux. [Tidal Hi-Fi](https://github.com/Mastermindzh/tidal-hifi) by Rick van Lieshout is a community-made Electron wrapper around the Tidal web player, with Hi-Fi and Max quality support. +[Tidal Hi-Fi](https://github.com/Mastermindzh/tidal-hifi) by Rick van Lieshout is an Electron wrapper around the Tidal web player. Works, but it's essentially the web app packaged as a desktop app. ![Tidal Hi-Fi in the Flathub store](/images/tidal-hifi-flathub.avif) @@ -313,17 +392,21 @@ There's no official Tidal client for Linux. [Tidal Hi-Fi](https://github.com/Mas ## Utilities -### Bottles — running Windows software +### Bottles: running Windows software -[Bottles](https://usebottles.com/) lets you run Windows software via Wine. Install from Flathub — version 61 or newer. +[Bottles](https://usebottles.com/) lets you run Windows software via Wine. Bottles is **only officially distributed via Flatpak**; ignore any other versions you may find in the AUR or elsewhere, as they are not official and not supported by the Bottles developers. + +```bash +flatpak install flathub com.usebottles.bottles +``` -- Open GNOME Software Center, search for "Bottles", select the **Flathub** source +Alternatively, open GNOME Software Center, search for "Bottles", and make sure to select the **Flathub** source. -For anything that doesn't work under Wine — like Microsoft 365 — I use a Windows VM instead. See [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}). +For anything that doesn't work under Wine (like Microsoft 365), I use a Windows VM instead. See [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}). ![Bottles in the Flathub store](/images/bottles-flathub.avif) -### Smile — emoji picker +### Smile: emoji picker [Smile](https://mijorus.it/projects/smile) by Lorenzo Paderi is a simple emoji picker for Linux with custom tags support. Available on Flathub. @@ -335,9 +418,9 @@ flatpak install flathub it.mijorus.smile **Settings** -Enable "Run in the background" and "Minimize on exit" in Smile's settings — this keeps the picker instant and dismisses it cleanly after selecting an emoji: +Enable "Run in the background" and "Minimize on exit" in Smile's settings. This keeps the picker instant and dismisses it cleanly after selecting an emoji: -![Smile settings — run in background, minimize on exit](/images/smile-settings.avif) +![Smile settings - run in background, minimize on exit](/images/smile-settings.avif) **GNOME extension** @@ -347,7 +430,7 @@ Install the [Smile complementary extension](https://extensions.gnome.org/extensi In the Smile settings under "Paste emojis automatically", make sure the extension toggle is enabled after installing. {{< /callout >}} -**Keyboard shortcut — repurposing the Copilot key** +**Keyboard shortcut: repurposing the Copilot key** The Copilot key on the Zephyrus G16 is otherwise useless on Linux. GNOME registers it as `Shift+Super+TouchpadOff`. Repurpose it as an emoji picker shortcut: @@ -359,7 +442,7 @@ Go to **Settings → Keyboard → Custom Shortcuts** and add: ![Custom shortcuts list showing Emoji picker entry](/images/smile-custom-shortcuts.avif) -![Custom shortcut dialog for Smile — Copilot key binding](/images/smile-shortcut-dialog.avif) +![Custom shortcut dialog for Smile - Copilot key binding](/images/smile-shortcut-dialog.avif) ### Solaar for Logitech devices @@ -373,4 +456,4 @@ sudo pacman -S solaar Runs in the system tray with battery notifications. You can also configure DPI, polling rate, and buttons from there. -![Solaar about screen — version 1.1.19](/images/solaar-about.avif) +![Solaar about screen - version 1.1.19](/images/solaar-about.avif) diff --git a/content/docs/applications.nl.md b/content/docs/applications.nl.md index 624e14b..9b1b1c0 100644 --- a/content/docs/applications.nl.md +++ b/content/docs/applications.nl.md @@ -1,6 +1,8 @@ --- title: "Applicaties" -weight: 25 +weight: 4 +prev: docs/security/yubikey +next: docs/networking/eduroam-network-installation --- Alles wat ik heb geïnstalleerd na de initiële CachyOS-setup. Losjes georganiseerd per categorie. De meeste keuzes zijn persoonlijk, maar de secties over Brave en libinput-config bevatten niet-voor-de-hand-liggende workarounds die nergens anders gedocumenteerd staan. @@ -9,23 +11,23 @@ Alles wat ik heb geïnstalleerd na de initiële CachyOS-setup. Losjes georganise Op CachyOS zijn er drie plekken om software vandaan te halen. Zoek ze in deze volgorde: -1. **[CachyOS packages](https://packages.cachyos.org/)** — de eigen repository van CachyOS, gebouwd bovenop Arch. Packages hier zijn geoptimaliseerd voor moderne CPU's (x86-64-v3/v4) en bevatten CachyOS-specifieke patches. Installeren met `sudo pacman -S `. +1. **[CachyOS packages](https://packages.cachyos.org/)**: de eigen repository van CachyOS, gebouwd bovenop Arch. Packages hier zijn geoptimaliseerd voor moderne CPU's (x86-64-v3/v4) en bevatten CachyOS-specifieke patches. Installeren met `sudo pacman -S `. -2. **[AUR](https://aur.archlinux.org/)** (Arch User Repository) — community-beheerde buildscripts voor software die niet in de officiële repos staat. Installeren met een AUR-helper zoals `paru -S `. Kwaliteit verschilt per package, maar de AUR dekt vrijwel alles. +2. **[AUR](https://aur.archlinux.org/)** (Arch User Repository): community-beheerde buildscripts voor software die niet in de officiële repos staat. Installeren met een AUR-helper zoals `paru -S `. Kwaliteit verschilt per package, maar de AUR dekt vrijwel alles. -3. **[Flathub](https://flathub.org/)** — Flatpak-packages die hun eigen dependencies meebrengen. Installeren met `flatpak install flathub `, starten met `flatpak run `. +3. **[Flathub](https://flathub.org/)**: Flatpak-packages die hun eigen dependencies meebrengen. Installeren met `flatpak install flathub `, starten met `flatpak run `. -**Native (pacman/paru) vs Flatpak — wat kies je?** +**Native (pacman/paru) vs Flatpak: wat kies je?** | | Native (pacman/paru) | Flatpak | |---|---|---| -| **Performance** | Beter — gebruikt gedeelde systeembibliotheken | Iets minder — bundelt eigen bibliotheken | -| **Integratie** | Nauw — volledige systeemtoegang | Sandbox — meer geïsoleerd | +| **Performance** | Beter (gebruikt gedeelde systeembibliotheken) | Iets minder (bundelt eigen bibliotheken) | +| **Integratie** | Nauw (volledige systeemtoegang) | Sandbox (meer geïsoleerd) | | **Grootte** | Kleiner | Groter | | **Compatibiliteit** | Afhankelijk van de distro | Consistent op alle distro's | | **Veiligheid** | Standaard | Betere sandboxing | -Native packages bieden betere performance en systeemintegratie. Flatpaks ruilen wat efficiëntie in voor compatibiliteit en sandboxing. De keuze is per applicatie aan jou — beide werken prima op CachyOS. +Native packages bieden betere performance en systeemintegratie. Flatpaks ruilen wat efficiëntie in voor compatibiliteit en sandboxing. De keuze is per applicatie aan jou; beide werken prima op CachyOS. ## Initiële systeeminstellingen @@ -35,7 +37,7 @@ Gewoon de hostname instellen via Systeeminstellingen zodat de machine een fatsoe ![Hostname instellen](/images/system-info.avif) -### GNOME-vensterknoppen — minimize en maximize terug +### GNOME-vensterknoppen: minimize en maximize terug Standaard toont GNOME 49 alleen de sluitknop. Eén commando lost het op: @@ -45,7 +47,7 @@ gsettings set org.gnome.desktop.wm.preferences button-layout 'appmenu:minimize,m ![Voorbeeld van hoe de nieuwe GNOME-vensters eruitzien](/images/window-controls.avif) -### GNOME-sneltoetsen — meer als Windows +### GNOME-sneltoetsen: meer als Windows Als je vanuit Windows komt, voelt een paar dingen meteen anders zonder de juiste sneltoetsen. Dit zijn de sneltoetsen die ik heb ingesteld. @@ -65,9 +67,9 @@ Als je vanuit Windows komt, voelt een paar dingen meteen anders zonder de juiste | 5 | Bestandsbeheer openen | `nautilus` | `Super+E` | | 6 | Emoji-picker | `flatpak run it.mijorus.smile` | Copilot-toets | -GNOME heeft standaard geen sneltoetsen voor de bestandsbeheerder of een emoji-picker — die moet je handmatig aanmaken. Zie [Smile](#smile--emoji-picker) voor hoe de Copilot-toets wordt gebruikt. +GNOME heeft standaard geen sneltoetsen voor de bestandsbeheerder of een emoji-picker, die moet je handmatig aanmaken. Zie [Smile](#smile-emoji-picker) voor hoe de Copilot-toets wordt gebruikt. -### GNOME-vensterfocus — apps die op de achtergrond openen +### GNOME-vensterfocus: apps die op de achtergrond openen Apps zoals Signal en Discord openen soms op de achtergrond, met een melding "Your app is ready" in plaats van het venster naar voren te brengen. Dit los je op met: @@ -75,9 +77,9 @@ Apps zoals Signal en Discord openen soms op de achtergrond, met een melding "You gsettings set org.gnome.desktop.wm.preferences focus-new-windows 'smart' ``` -De standaard `strict`-modus brengt nieuwe vensters nooit automatisch naar voren. `smart` laat GNOME zelf beslissen — in de praktijk betekent dit dat nieuw geopende apps gewoon op de voorgrond verschijnen. +De standaard `strict`-modus brengt nieuwe vensters nooit automatisch naar voren. `smart` laat GNOME zelf beslissen; in de praktijk betekent dit dat nieuw geopende apps gewoon op de voorgrond verschijnen. -### Touchpad-scrollsnelheid — geen native GNOME-instelling (nog niet) +### Touchpad-scrollsnelheid: geen native GNOME-instelling (nog niet) GNOME 49 heeft simpelweg **geen instelling** voor touchpad-scrollsnelheid. KDE Plasma heeft dat al jaren. Er zijn merge requests open in [mutter](https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1840) en [GNOME Control Center](https://gitlab.gnome.org/GNOME/gnome-control-center/-/merge_requests/991), maar die staan al jaren open. Zie de [GNOME Discourse-discussie](https://discourse.gnome.org/t/adding-scroll-speed-setting-in-gnome/25893) voor meer context. @@ -135,14 +137,14 @@ sudo rm /etc/libinput.conf ### Brave -Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar het native pakket — dat beter integreert met het systeem en betere prestaties biedt. +Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar het native pakket, dat beter integreert met het systeem en betere prestaties biedt. - **Native (pacman):** Betere integratie, betere prestaties. Dit gebruik ik. - **Flatpak:** Kan in sommige situaties beter werken, maar voelt wat geïsoleerder. **Installatie** -[brave-bin in CachyOS packages](https://packages.cachyos.org/package/cachyos/x86_64/brave-bin) — direct beschikbaar in de CachyOS-repo, geen AUR-helper nodig. +[brave-bin in CachyOS packages](https://packages.cachyos.org/package/cachyos/x86_64/brave-bin): direct beschikbaar in de CachyOS-repo, geen AUR-helper nodig. ```bash sudo pacman -S brave-bin @@ -150,7 +152,7 @@ sudo pacman -S brave-bin ![Officiële Brave Linux installatie-instructies](/images/brave-linux-install.avif) -Hardware acceleration werkt prima met huidige Brave- en kernelversies. De crashbugs die Brave 1.82–1.86 troffen zijn opgelost — zie [Bekende Problemen]({{< relref "/docs/known-issues" >}}) voor de achtergrond. +Hardware acceleration werkt prima met huidige Brave- en kernelversies. De crashbugs die Brave 1.82–1.86 troffen zijn opgelost. Zie [Bekende Problemen]({{< relref "/docs/known-issues" >}}) voor de achtergrond. **Flatpak-alternatief** @@ -173,16 +175,82 @@ Wachtwoordbeheerder. Beschikbaar via Flathub en werkt goed. ### Signal Messenger -Signal is mijn belangrijkste berichtenapp. Officieel alleen ondersteund op Debian/Ubuntu, maar de Flatpak-versie werkt prima op CachyOS. +Signal is mijn belangrijkste berichtenapp. De [CachyOS extra-repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) levert een native pakket, wat ik gebruik en het werkt beter dan de Flatpak. + +**CachyOS / Arch (aanbevolen):** + +```bash +sudo pacman -S signal-desktop +``` + +**Flatpak (alternatief):** + +```bash +flatpak install flathub org.signal.Signal +``` ![Signal Messenger app in Flathub](/images/signal-flathub.avif) ### Proton Mail -De Proton Mail desktop-app is een wrapper rondom de webapp, geen native client. Werkt gewoon en staat in de app launcher zoals elke andere app. +De Proton Mail desktop-app is een wrapper rondom de webapp, geen native client. De [CachyOS-repository](https://packages.cachyos.org/package/cachyos/any/proton-mail-bin) levert `proton-mail-bin`, dat natiever integreert in het bureaublad dan de Flatpak: beter systeemvak-gedrag, systeemnotificaties en geen Flatpak-sandboxoverhead. + +**CachyOS / Arch (aanbevolen):** + +```bash +sudo pacman -S proton-mail-bin +``` + +**Flatpak (alternatief):** + +```bash +flatpak install flathub me.proton.Mail +``` ![Proton Mail app in Flathub](/images/protonmail-flathub.avif) +### Kantoorpakketten + +Er bestaat geen officiële Microsoft 365-client voor Linux. Twee goede alternatieven dekken de meeste use cases. + +#### OnlyOffice + +[OnlyOffice](https://packages.cachyos.org/package/cachyos/x86_64/onlyoffice-bin) lijkt het meest op Microsoft 365. De interface is bijna identiek, met Word-, Excel- en PowerPoint-equivalenten die er uitzien en werken als de Microsoft-originals. Goede compatibiliteit met `.docx`-, `.xlsx`- en `.pptx`-bestanden. + +```bash +sudo pacman -S onlyoffice-bin +``` + +![OnlyOffice draaiend op GNOME](/images/only-office.avif) + +**Ontbrekend: APA-stijl verwijzingen** + +Een opvallend gemis voor academisch werk: OnlyOffice heeft geen ingebouwde citatiebeheerder of APA-referentiestijl standaard. + +![OnlyOffice - referenties-functie ontbreekt](/images/only-office-missing_references.avif) + +Er zijn workarounds via plugins. Het [OnlyOffice helpcenter documenteert referentiebeheer](https://helpcenter.onlyoffice.com/docs/userguides/plugins/InsertReferences.aspx) via integraties zoals Zotero of Mendeley, beide citatiebeheerders die in de editor kunnen worden gekoppeld. Ik heb dit zelf nog niet opgezet, dus ik kan niet goed beoordelen hoe goed dit in de praktijk werkt. + +#### LibreOffice + +[LibreOffice Fresh](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/libreoffice-fresh) is de meest actief ontwikkelde open-source kantoorapplicatie en de meest Linux-native optie. Er gaat meer ontwikkelinspanning in dan in welk alternatief dan ook. + +```bash +sudo pacman -S libreoffice-fresh +``` + +**APA-verwijzingen: ingebouwd** + +Anders dan OnlyOffice heeft LibreOffice een ingebouwde bibliografiedatabase en referentie-invoeg functie. Je kunt je bronnen beheren en citaten in APA-stijl invoegen direct vanuit de menu's: + +![LibreOffice bibliografiebeheerder](/images/libreoffice-bibliograpy.avif) + +![LibreOffice - verwijzingen invoegen](/images/libreoffice-inserting_references.avif) + +**Kanttekening: Microsoft-formaatcompatibiliteit** + +LibreOffice kan `.docx`/`.xlsx`/`.pptx`-bestanden openen en opslaan, maar er zijn bekende renderingsverschillen met documenten die in Microsoft Word zijn gemaakt. Dit komt doordat Microsoft en LibreOffice de OpenXML-standaard niet altijd identiek hebben geïmplementeerd, wat tot renderingsverschillen leidt. Voor documenten die binnen LibreOffice's eigen ODF-formaat blijven, zijn er geen problemen. + --- ## Ontwikkeling @@ -195,19 +263,23 @@ sudo pacman -S git github-cli ### Visual Studio Code +Er zijn twee builds beschikbaar. De **Microsoft-build** bevat de volledige Microsoft extension marketplace en proprietary extensies zoals GitHub Copilot. De **open-source build** (`code`) heeft geen Microsoft-telemetrie of branding, maar proprietary extensies zijn niet beschikbaar. + +**Microsoft-build (aanbevolen, volledige extensie-ondersteuning):** + ```bash -sudo pacman -S code +paru -S visual-studio-code-bin ``` -{{< callout type="warning" >}} -Op kernel 6.18.x/6.19.x kan hardware acceleration in VS Code een amdgpu page fault veroorzaken waardoor het systeem bevriest. Zet hardware acceleration uit door dit toe te voegen aan `~/.config/Code/User/settings.json`: -```json -{ - "disable-hardware-acceleration": true -} +Beschikbaar in de [AUR](https://aur.archlinux.org/packages/visual-studio-code-bin). + +**Open-source build (geen Microsoft-telemetrie):** + +```bash +sudo pacman -S code ``` -Zie [Bekende Problemen]({{< relref "/docs/known-issues" >}}) voor details. -{{< /callout >}} + +Beschikbaar in de [CachyOS extra-repository](https://packages.cachyos.org/package/cachyos-extra-znver4/x86_64_v4/code). ### Kleopatra & GPG commit signing @@ -232,13 +304,13 @@ Gebruik de ID van de `sec` regel (bijv. `rsa4096/JOUW_GPG_KEY_ID`). ### Archi (ArchiMate-modelleertool) -[Archi](https://www.archimatetool.com/) is een gratis ArchiMate-modelleertool. Het Linux-pakket is een portable archief — geen installer. Om het netjes in GNOME te laten verschijnen met een icoon, moet je de bestanden zelf plaatsen en een desktop entry handmatig aanmaken. +[Archi](https://www.archimatetool.com/) is een gratis ArchiMate-modelleertool. Het Linux-pakket is een portable archief zonder installer. Om het netjes in GNOME te laten verschijnen met een icoon, moet je de bestanden zelf plaatsen en een desktop entry handmatig aanmaken. {{< callout type="info" >}} De downloadpagina van Archi waarschuwt voor mogelijke UI-problemen op Wayland. In mijn ervaring werkt hij prima op GNOME 49 Wayland. {{< /callout >}} -![Archi downloadpagina — Linux versie met Wayland-opmerking](/images/archi-download.avif) +![Archi downloadpagina - Linux versie met Wayland-opmerking](/images/archi-download.avif) ```bash # Download en extraheer @@ -286,26 +358,33 @@ Na het opslaan verschijnt Archi in de GNOME-app launcher: ### Steam -Op CachyOS is Steam beschikbaar vanuit de `multilib` repository — geen extra repos nodig. +Op CachyOS is Steam beschikbaar vanuit de [CachyOS-repository](https://packages.cachyos.org/package/cachyos/x86_64/steam), geen extra repos nodig. ```bash sudo pacman -S steam ``` -![Steam in GNOME Software](/images/steam-gnome-software.avif) +![Steam in GNOME Software](/images/steam-website.avif) Herstart na installatie. Steam bevat Proton standaard voor het draaien van Windows-games op Linux. -{{< callout type="info" >}} -Als Steam niet wil starten, probeer het dan vanuit de terminal: +### Tidal + +Er is geen officiële Tidal-client voor Linux. Er zijn twee community-alternatieven. + +#### High Tide (aanbevolen) + +[High Tide](https://aur.archlinux.org/packages/high-tide) is een native GTK4-frontend voor Tidal, geen Electron-wrapper, maar een echte applicatie gebouwd met een proper Linux-toolkit. Ziet er strak uit, integreert goed met GNOME en ondersteunt Hi-Fi kwaliteit. + ```bash -__GL_CONSTANT_FRAME_RATE_HINT=3 steam +paru -S high-tide ``` -{{< /callout >}} -### Tidal Hi-Fi +![High Tide draaiend op GNOME](/images/high-tide.avif) + +#### Tidal Hi-Fi -Er is geen officiële Tidal-client voor Linux. [Tidal Hi-Fi](https://github.com/Mastermindzh/tidal-hifi) van Rick van Lieshout is een community-Electron-wrapper rondom de Tidal-webapp, met Hi-Fi en Max kwaliteitsondersteuning. +[Tidal Hi-Fi](https://github.com/Mastermindzh/tidal-hifi) van Rick van Lieshout is een Electron-wrapper rondom de Tidal-webapp. Werkt prima, maar het is in feite de webapp verpakt als desktopapp. ![Tidal Hi-Fi in de Flathub store](/images/tidal-hifi-flathub.avif) @@ -313,17 +392,21 @@ Er is geen officiële Tidal-client voor Linux. [Tidal Hi-Fi](https://github.com/ ## Hulpprogramma's -### Bottles — Windows-software draaien +### Bottles: Windows-software draaien -[Bottles](https://usebottles.com/) laat je Windows-software draaien via Wine. Installeer via Flathub — versie 61 of nieuwer. +[Bottles](https://usebottles.com/) laat je Windows-software draaien via Wine. Bottles wordt **uitsluitend officieel via Flatpak geleverd**; negeer eventuele andere versies in de AUR of elders, want die zijn niet officieel en worden niet ondersteund door de Bottles-ontwikkelaars. + +```bash +flatpak install flathub com.usebottles.bottles +``` -- Open GNOME Software Center, zoek naar "Bottles", selecteer de **Flathub** bron +Je kunt ook GNOME Software Center openen, zoeken naar "Bottles" en er zeker van zijn dat je de **Flathub** bron selecteert. -Voor wat niet werkt onder Wine — zoals Microsoft 365 — gebruik ik een Windows VM. Zie [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}). +Voor wat niet werkt onder Wine (zoals Microsoft 365), gebruik ik een Windows VM. Zie [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}). ![Bottles in de Flathub store](/images/bottles-flathub.avif) -### Smile — emoji-picker +### Smile: emoji-picker [Smile](https://mijorus.it/projects/smile) van Lorenzo Paderi is een eenvoudige emoji-picker voor Linux met ondersteuning voor aangepaste tags. Beschikbaar via Flathub. @@ -335,9 +418,9 @@ flatpak install flathub it.mijorus.smile **Instellingen** -Zet "Run in the background" en "Minimize on exit" aan in de Smile-instellingen — zo opent de picker direct en verdwijnt hij netjes na het kiezen van een emoji: +Zet "Run in the background" en "Minimize on exit" aan in de Smile-instellingen. Zo opent de picker direct en verdwijnt hij netjes na het kiezen van een emoji: -![Smile-instellingen — run in background, minimize on exit](/images/smile-settings.avif) +![Smile-instellingen - run in background, minimize on exit](/images/smile-settings.avif) **GNOME-extensie** @@ -347,7 +430,7 @@ Installeer de [Smile complementary extension](https://extensions.gnome.org/exten Zorg er na het installeren van de extensie voor dat de extensie-toggle in de Smile-instellingen onder "Paste emojis automatically" is ingeschakeld. {{< /callout >}} -**Sneltoets — de Copilot-toets hergebruiken** +**Sneltoets: de Copilot-toets hergebruiken** De Copilot-toets op de Zephyrus G16 doet op Linux standaard niets nuttigs. GNOME registreert hem als `Shift+Super+TouchpadOff`. Hergebruik hem als sneltoets voor de emoji-picker: @@ -359,7 +442,7 @@ Ga naar **Instellingen → Toetsenbord → Aangepaste sneltoetsen** en voeg toe: ![Overzicht aangepaste sneltoetsen met Emoji picker](/images/smile-custom-shortcuts.avif) -![Dialoog voor aangepaste sneltoets voor Smile — Copilot-toets](/images/smile-shortcut-dialog.avif) +![Dialoog voor aangepaste sneltoets voor Smile - Copilot-toets](/images/smile-shortcut-dialog.avif) ### Solaar voor Logitech-apparaten @@ -373,4 +456,4 @@ sudo pacman -S solaar Draait in het systray met batterijnotificaties. Je kunt er ook DPI, polling rate en knoppen mee configureren. -![Solaar about screen — version 1.1.19](/images/solaar-about.avif) +![Solaar about screen - version 1.1.19](/images/solaar-about.avif) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index efcc032..4f09610 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -1,11 +1,12 @@ --- title: "Getting Started" -weight: 2 +weight: 1 +next: docs/hardware/nvidia-driver-installation --- -This is my personal setup documentation for the ROG Zephyrus G16 running CachyOS (Arch). I'm not a software engineer or developer — just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error. +This is my personal setup documentation for the ROG Zephyrus G16 running CachyOS (Arch). I'm not a software engineer or developer, just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error. -If something here helps you, great. If you run into something I haven't covered, feel free to reach out — I'm happy to think along. +If something here helps you, great. If you run into something I haven't covered, feel free to reach out; I'm happy to think along. ## Hardware @@ -26,21 +27,21 @@ If something here helps you, great. If you run into something I haven't covered, After testing multiple distributions, I settled on CachyOS (Arch) as my daily driver. CachyOS is an Arch-based distribution with hardware-specific optimizations that make it stand out for the Zephyrus G16: -- **BORE/EEVDF scheduler** — CachyOS ships with an improved CPU scheduler that provides better responsiveness and lower latency under mixed workloads -- **Improved power management** — Better handling of suspend/resume and ACPI power states on AMD+NVIDIA hybrid setups -- **Dynamic refresh rate support** — Out-of-the-box support for variable refresh rate on the ROG Nebula Display -- **Built-in iGPU and dGPU drivers** — The AMD Radeon 890M and NVIDIA RTX 4060 work correctly from a fresh install, including GPU switching via `asusctl armoury` -- **ASUS Linux patches** — Part of [Luke Jones'](https://asus-linux.org/) work has been merged into the Linux kernel mainline (the `asus-armoury` driver since 6.19), while additional ROG-specific patches and `asusctl` tooling improvements are carried by CachyOS. Both `asusctl` and `rog-control-center` are available directly from the CachyOS repos — install two packages and you're done, no deep system configuration required. CachyOS currently ships the most complete set of optimizations for this hardware +- **BORE/EEVDF scheduler**: CachyOS ships with an improved CPU scheduler that provides better responsiveness and lower latency under mixed workloads +- **Improved power management**: better handling of suspend/resume and ACPI power states on AMD+NVIDIA hybrid setups +- **Dynamic refresh rate support**: out-of-the-box support for variable refresh rate on the ROG Nebula Display +- **Built-in iGPU and dGPU drivers**: the AMD Radeon 890M and NVIDIA RTX 4060 work correctly from a fresh install, including GPU switching via `asusctl armoury` +- **ASUS Linux patches**: part of [Luke Jones'](https://asus-linux.org/) work has been merged into the Linux kernel mainline (the `asus-armoury` driver since 6.19), while additional ROG-specific patches and `asusctl` tooling improvements are carried by CachyOS. Both `asusctl` and `rog-control-center` are available directly from the CachyOS repos; install two packages and you're done, no deep system configuration required. CachyOS currently ships the most complete set of optimizations for this hardware -Fedora is a strong second — a solid option if you prefer a more stable release cycle over rolling, and you're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box. +Fedora is a strong second, a solid option if you prefer a more stable release cycle over rolling, and you're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box. ## CachyOS Kernel Manager -CachyOS ships the **CachyOS Kernel Manager** as a pre-installed GUI tool. It lets you manage installed kernels and configure the `sched-ext` scheduler — the Linux kernel's extensible scheduler framework that allows userspace schedulers to replace the default one. +CachyOS ships the **CachyOS Kernel Manager** as a pre-installed GUI tool. It lets you manage installed kernels and configure the `sched-ext` scheduler, the Linux kernel's extensible scheduler framework that allows userspace schedulers to replace the default one. I use `scx_lavd` with the profile set to **Auto**. LAVD (Latency-criticality Aware Virtual Deadline) is a scheduler designed for mixed interactive and compute workloads, which makes it well-suited for a laptop used for both daily tasks and gaming. -![CachyOS Kernel Manager — Configure sched-ext with scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif) +![CachyOS Kernel Manager - Configure sched-ext with scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif) The scheduler can be changed at any time without a reboot. @@ -67,7 +68,7 @@ Set up hardware-backed LUKS unlock with a YubiKey, and optionally configure GDM ### Applications -Install and configure applications — browser, communication tools, development environment, and utilities. Includes non-obvious workarounds for Brave on GNOME Wayland and touchpad scroll speed. +Install and configure applications: browser, communication tools, development environment, and utilities. Includes non-obvious workarounds for Brave on GNOME Wayland and touchpad scroll speed. → [Applications]({{< relref "/docs/applications" >}}) diff --git a/content/docs/getting-started.nl.md b/content/docs/getting-started.nl.md index c33e972..3105769 100644 --- a/content/docs/getting-started.nl.md +++ b/content/docs/getting-started.nl.md @@ -1,11 +1,12 @@ --- title: "Aan de slag" -weight: 2 +weight: 1 +next: docs/hardware/nvidia-driver-installation --- -Dit is mijn persoonlijke setup-documentatie voor de ROG Zephyrus G16 op CachyOS (Arch). Ik ben geen software-engineer of developer — gewoon iemand die overgestapt is naar Linux en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uit te zoeken als ik. +Dit is mijn persoonlijke setup-documentatie voor de ROG Zephyrus G16 op CachyOS (Arch). Ik ben geen software-engineer of developer, gewoon iemand die overgestapt is naar Linux en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uit te zoeken als ik. -Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb, laat het gerust weten — ik denk graag mee. +Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb, laat het gerust weten; ik denk graag mee. ## Hardware @@ -26,21 +27,21 @@ Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb, Na het testen van meerdere distributies ben ik overgestapt op CachyOS (Arch) als mijn dagelijkse driver. CachyOS is een op Arch gebaseerde distributie met hardware-specifieke optimalisaties die het onderscheiden voor de Zephyrus G16: -- **BORE/EEVDF scheduler** — CachyOS wordt geleverd met een verbeterde CPU-scheduler die betere responsiviteit en lagere latency biedt bij gemengde workloads -- **Verbeterd energiebeheer** — Betere afhandeling van suspend/resume en ACPI power states op AMD+NVIDIA hybride setups -- **Ondersteuning voor dynamische verversingsfrequentie** — Standaard ondersteuning voor variable refresh rate op het ROG Nebula Display -- **Ingebouwde iGPU- en dGPU-drivers** — De AMD Radeon 890M en NVIDIA RTX 4060 werken correct vanaf een verse installatie, inclusief GPU-switching via `asusctl armoury` -- **ASUS Linux-patches** — Een deel van het werk van [Luke Jones](https://asus-linux.org/) is gemerged in de Linux kernel zelf (de `asus-armoury`-driver vanaf 6.19), terwijl aanvullende ROG-specifieke patches en `asusctl`-verbeteringen via CachyOS worden meegeleverd. Zowel `asusctl` als `rog-control-center` zijn direct beschikbaar vanuit de CachyOS repos — twee packages installeren en je bent klaar, zonder diepe systeemconfiguratie. CachyOS bevat op dit moment de meest volledige set aan optimalisaties voor deze hardware +- **BORE/EEVDF scheduler**: CachyOS wordt geleverd met een verbeterde CPU-scheduler die betere responsiviteit en lagere latency biedt bij gemengde workloads +- **Verbeterd energiebeheer**: betere afhandeling van suspend/resume en ACPI power states op AMD+NVIDIA hybride setups +- **Ondersteuning voor dynamische verversingsfrequentie**: standaard ondersteuning voor variable refresh rate op het ROG Nebula Display +- **Ingebouwde iGPU- en dGPU-drivers**: de AMD Radeon 890M en NVIDIA RTX 4060 werken correct vanaf een verse installatie, inclusief GPU-switching via `asusctl armoury` +- **ASUS Linux-patches**: een deel van het werk van [Luke Jones](https://asus-linux.org/) is gemerged in de Linux kernel zelf (de `asus-armoury`-driver vanaf 6.19), terwijl aanvullende ROG-specifieke patches en `asusctl`-verbeteringen via CachyOS worden meegeleverd. Zowel `asusctl` als `rog-control-center` zijn direct beschikbaar vanuit de CachyOS repos; twee packages installeren en je bent klaar, zonder diepe systeemconfiguratie. CachyOS bevat op dit moment de meest volledige set aan optimalisaties voor deze hardware -Fedora is een sterke tweede — een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. Dat gezegd hebbende voelt CachyOS nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driver ondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie. +Fedora is een sterke tweede, een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. Dat gezegd hebbende voelt CachyOS nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driver ondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie. ## CachyOS Kernel Manager -CachyOS wordt geleverd met de **CachyOS Kernel Manager** als voorgeïnstalleerde GUI-tool. Hiermee beheer je geïnstalleerde kernels en configureer je de `sched-ext` scheduler — het extensible scheduler framework van de Linux kernel waarmee een userspace-scheduler de standaard kan vervangen. +CachyOS wordt geleverd met de **CachyOS Kernel Manager** als voorgeïnstalleerde GUI-tool. Hiermee beheer je geïnstalleerde kernels en configureer je de `sched-ext` scheduler, het extensible scheduler framework van de Linux kernel waarmee een userspace-scheduler de standaard kan vervangen. Ik gebruik `scx_lavd` met het profiel ingesteld op **Auto**. LAVD (Latency-criticality Aware Virtual Deadline) is een scheduler die ontworpen is voor gemengde interactieve en compute-workloads, wat hem goed geschikt maakt voor een laptop die je zowel dagelijks als voor gaming gebruikt. -![CachyOS Kernel Manager — Configure sched-ext met scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif) +![CachyOS Kernel Manager - Configure sched-ext met scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif) De scheduler kan op elk moment worden gewijzigd zonder herstart. @@ -67,7 +68,7 @@ Stel hardware-gebaseerde LUKS-ontgrendeling in met een YubiKey, en configureer o ### Applicaties -Installeer en configureer applicaties — browser, communicatietools, ontwikkelomgeving en hulpprogramma's. Inclusief niet-voor-de-hand-liggende workarounds voor Brave op GNOME Wayland en touchpad-scrollsnelheid. +Installeer en configureer applicaties: browser, communicatietools, ontwikkelomgeving en hulpprogramma's. Inclusief niet-voor-de-hand-liggende workarounds voor Brave op GNOME Wayland en touchpad-scrollsnelheid. → [Applicaties]({{< relref "/docs/applications" >}}) diff --git a/content/docs/hardware/_index.md b/content/docs/hardware/_index.md index 4a4218b..1d31375 100644 --- a/content/docs/hardware/_index.md +++ b/content/docs/hardware/_index.md @@ -1,6 +1,6 @@ --- title: "Hardware & Drivers" -weight: 10 +weight: 2 toc: false --- diff --git a/content/docs/hardware/_index.nl.md b/content/docs/hardware/_index.nl.md index 33ea13a..95ff766 100644 --- a/content/docs/hardware/_index.nl.md +++ b/content/docs/hardware/_index.nl.md @@ -1,6 +1,6 @@ --- title: "Hardware & Drivers" -weight: 10 +weight: 2 toc: false --- diff --git a/content/docs/hardware/asusctl-rog-control.md b/content/docs/hardware/asusctl-rog-control.md index 7f3006c..88c34c0 100644 --- a/content/docs/hardware/asusctl-rog-control.md +++ b/content/docs/hardware/asusctl-rog-control.md @@ -1,14 +1,16 @@ --- title: "asusctl & ROG Control Center" -weight: 22 +weight: 3 +next: docs/security/autologin --- -The Zephyrus G16 has a lot of hardware features that don't work out of the box on Linux — fan curves, performance profiles, the Slash LED on the lid, GPU switching, battery charge limiting. This page documents how I got all of it working using asusctl and the ASUS Linux project tools. On CachyOS, these tools are available directly from the package repos. +The Zephyrus G16 has a lot of hardware features that don't work out of the box on Linux: fan curves, performance profiles, the Slash LED on the lid, GPU switching, battery charge limiting. This page documents how I got all of it working using asusctl and the ASUS Linux project tools. On CachyOS, these tools are available directly from the package repos. **Package Information:** -- `asusctl` 6.3.2-1 — CLI for fan curves, profiles, battery limit, RGB, Slash LED, GPU switching -- `asusctl-rog-gui` 6.3.2 — ROG Control Center GUI -- Source: CachyOS/Arch repos (packages maintained by Luke Jones, primary asusctl developer) +- `asusd` 6.3.4: background daemon (backend) that manages all hardware features +- `asusctl` 6.3.4: CLI frontend for fan curves, profiles, battery limit, RGB, Slash LED, GPU switching +- `rog-control-center` 6.3.4: graphical frontend, part of the asusctl/asusd suite +- Source: [asus-linux releases](https://gitlab.com/asus-linux/asusctl/-/releases) · available in CachyOS/Arch repos ## Installation @@ -22,10 +24,11 @@ sudo pacman -S asusctl rog-control-center ``` This installs: -- `asusctl` — main CLI daemon and client -- `asusctl-rog-gui` — ROG Control Center GUI +- `asusd`: the backend daemon that manages all ASUS hardware features +- `asusctl`: CLI frontend that communicates with asusd +- `rog-control-center`: graphical frontend that communicates with asusd -On CachyOS this is all you need — both packages are available directly from the repos and everything works out of the box. No kernel patching or deep system configuration required. +On CachyOS this is all you need; both packages are available directly from the repos and everything works out of the box. No kernel patching or deep system configuration required. ### Enable services @@ -111,9 +114,9 @@ asusctl slash --enable -b false -s false ``` **What these flags do:** -- `--enable` — turn on the Slash LED -- `-b false` — disable on battery power -- `-s false` — disable during sleep +- `--enable`: turn on the Slash LED +- `-b false`: disable on battery power +- `-s false`: disable during sleep **Set animation:** ```bash @@ -295,13 +298,13 @@ Known issues and troubleshooting for asusctl & ROG Control Center are documented ### Kernel 6.19: asus-armoury driver lands in mainline -The `asus-armoury` driver has been [merged into Linux 6.19](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19). This new `platform/x86` driver replaces parts of the older `asus-wmi` with a cleaner sysfs-based API, enabling panel mode switching, APU memory allocation, PPT tuning, and more directly from the kernel. The driver is entirely community-developed by [Luke Jones](https://asus-linux.org/) (ASUS Linux project), with no involvement from ASUS themselves. CachyOS ships kernel 6.19.3-2 which includes this driver and additional ASUS-specific patches. +The `asus-armoury` driver has been [merged into Linux 6.19](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19). This new `platform/x86` driver replaces parts of the older `asus-wmi` with a cleaner sysfs-based API, enabling panel mode switching, APU memory allocation, PPT tuning, and more directly from the kernel. The driver is entirely community-developed by the [asus-linux team](https://asus-linux.org/), with no involvement from ASUS themselves. CachyOS ships kernel 6.19.3-2 which includes this driver and additional ASUS-specific patches. -**Before** — basic asusctl controls without Armoury settings: +**Before**: basic asusctl controls without Armoury settings: ![ROG Control before asus-armoury in mainline](/images/rog-control-armoury.avif) -**After** — full Armoury settings exposed, including PPT/power limit tuning: +**After**: full Armoury settings exposed, including PPT/power limit tuning: ![ROG Control System Control with Armoury settings and power limit tuning](/images/rog-control-system-control.avif) @@ -316,7 +319,7 @@ Linus confirmed the next kernel will be 7.0, with the merge window now open and ## Additional Resources -- [asus-linux.org](https://asus-linux.org/) — Official project site -- [asusctl GitLab](https://gitlab.com/asus-linux/asusctl) — Source code and issue tracker -- [CachyOS Wiki: ASUS](https://wiki.cachyos.org/) — CachyOS-specific documentation -- [NVIDIA Driver Installation Guide]({{< relref "/docs/hardware/nvidia-driver-installation" >}}) — NVIDIA driver setup and known issues +- [asus-linux.org](https://asus-linux.org/): official project site +- [asusctl GitLab](https://gitlab.com/asus-linux/asusctl): source code and issue tracker +- [CachyOS Wiki: ASUS](https://wiki.cachyos.org/): CachyOS-specific documentation +- [NVIDIA Driver Installation Guide]({{< relref "/docs/hardware/nvidia-driver-installation" >}}): NVIDIA driver setup and known issues diff --git a/content/docs/hardware/asusctl-rog-control.nl.md b/content/docs/hardware/asusctl-rog-control.nl.md index 0efa96c..4c30941 100644 --- a/content/docs/hardware/asusctl-rog-control.nl.md +++ b/content/docs/hardware/asusctl-rog-control.nl.md @@ -1,14 +1,16 @@ --- title: "asusctl & ROG Control Center" -weight: 22 +weight: 3 +next: docs/security/autologin --- -De Zephyrus G16 heeft veel hardware-functies die op Linux niet zomaar werken — fan curves, performance-profielen, de Slash LED op het deksel, GPU-switching, batterijlaadlimiet. Op deze pagina staat hoe ik dat allemaal werkend heb gekregen met asusctl en de tools van het ASUS Linux-project. Op CachyOS zijn deze tools direct beschikbaar vanuit de package repos. +De Zephyrus G16 heeft veel hardware-functies die op Linux niet zomaar werken: fan curves, performance-profielen, de Slash LED op het deksel, GPU-switching, batterijlaadlimiet. Op deze pagina staat hoe ik dat allemaal werkend heb gekregen met asusctl en de tools van het ASUS Linux-project. Op CachyOS zijn deze tools direct beschikbaar vanuit de package repos. **Pakketinformatie:** -- `asusctl` 6.3.2 — CLI voor fan curves, profielen, batterijlimiet, RGB, Slash LED, GPU-switching -- `asusctl-rog-gui` 6.3.2 — ROG Control Center GUI -- Bron: CachyOS/Arch repos (packages beheerd door Luke Jones, primaire asusctl developer) +- `asusd` 6.3.4: achtergrond daemon (backend) die alle hardware-functies beheert +- `asusctl` 6.3.4: CLI frontend voor fan curves, profielen, batterijlimiet, RGB, Slash LED, GPU-switching +- `rog-control-center` 6.3.4: grafische frontend, onderdeel van de asusctl/asusd suite +- Bron: [asus-linux releases](https://gitlab.com/asus-linux/asusctl/-/releases) · beschikbaar in CachyOS/Arch repos ## Installatie @@ -22,10 +24,11 @@ sudo pacman -S asusctl rog-control-center ``` Dit installeert: -- `asusctl` — hoofd CLI daemon en client -- `asusctl-rog-gui` — ROG Control Center GUI +- `asusd`: de backend daemon die alle ASUS hardware-functies beheert +- `asusctl`: CLI frontend die communiceert met asusd +- `rog-control-center`: grafische frontend die communiceert met asusd -Op CachyOS is dit alles wat je nodig hebt — beide packages zijn direct beschikbaar vanuit de repos en alles werkt meteen. Geen kernel patches of diepe systeemconfiguratie vereist. +Op CachyOS is dit alles wat je nodig hebt; beide packages zijn direct beschikbaar vanuit de repos en alles werkt meteen. Geen kernel patches of diepe systeemconfiguratie vereist. ### Services activeren @@ -111,9 +114,9 @@ asusctl slash --enable -b false -s false ``` **Wat deze opties doen:** -- `--enable` — Slash LED inschakelen -- `-b false` — uitschakelen op batterijstroom -- `-s false` — uitschakelen tijdens slaapstand +- `--enable`: Slash LED inschakelen +- `-b false`: uitschakelen op batterijstroom +- `-s false`: uitschakelen tijdens slaapstand **Animatie instellen:** ```bash @@ -295,13 +298,13 @@ Bekende problemen en probleemoplossing voor asusctl & ROG Control Center staan o ### Kernel 6.19: asus-armoury driver in mainline Linux -De `asus-armoury` driver is [gemerged in Linux 6.19](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19). Deze nieuwe `platform/x86` driver vervangt delen van de oudere `asus-wmi` met een schonere sysfs-gebaseerde API, waarmee o.a. paneel modus wisselen, APU geheugentoewijzing, PPT tuning en meer mogelijk wordt direct vanuit de kernel. De driver is volledig ontwikkeld door de community, door [Luke Jones](https://asus-linux.org/) (ASUS Linux project), zonder enige betrokkenheid van ASUS zelf. CachyOS levert kernel 6.19.3-2, inclusief deze driver en aanvullende ASUS-specifieke patches. +De `asus-armoury` driver is [gemerged in Linux 6.19](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19). Deze nieuwe `platform/x86` driver vervangt delen van de oudere `asus-wmi` met een schonere sysfs-gebaseerde API, waarmee o.a. paneel modus wisselen, APU geheugentoewijzing, PPT tuning en meer mogelijk wordt direct vanuit de kernel. De driver is volledig door de community ontwikkeld door het [asus-linux team](https://asus-linux.org/), zonder enige betrokkenheid van ASUS zelf. CachyOS levert kernel 6.19.3-2, inclusief deze driver en aanvullende ASUS-specifieke patches. -**Voor** — basale asusctl-bediening zonder Armoury-instellingen: +**Voor**: basale asusctl-bediening zonder Armoury-instellingen: ![ROG Control voor asus-armoury in mainline](/images/rog-control-armoury.avif) -**Na** — volledige Armoury-instellingen zichtbaar, inclusief PPT/vermogenslimiet tuning: +**Na**: volledige Armoury-instellingen zichtbaar, inclusief PPT/vermogenslimiet tuning: ![ROG Control System Control met Armoury-instellingen en vermogenslimieten](/images/rog-control-system-control.avif) @@ -316,7 +319,7 @@ Linus heeft bevestigd dat de volgende kernel 7.0 is, met de merge window nu open ## Aanvullende Bronnen -- [asus-linux.org](https://asus-linux.org/) — Officiële projectsite -- [asusctl GitLab](https://gitlab.com/asus-linux/asusctl) — Broncode en issue tracker -- [CachyOS Wiki: ASUS](https://wiki.cachyos.org/) — CachyOS-specifieke documentatie -- [NVIDIA Driver Installatie Guide]({{< relref "/docs/hardware/nvidia-driver-installation" >}}) — NVIDIA driver setup en bekende problemen +- [asus-linux.org](https://asus-linux.org/): officiële projectsite +- [asusctl GitLab](https://gitlab.com/asus-linux/asusctl): broncode en issue tracker +- [CachyOS Wiki: ASUS](https://wiki.cachyos.org/): CachyOS-specifieke documentatie +- [NVIDIA Driver Installatie Guide]({{< relref "/docs/hardware/nvidia-driver-installation" >}}): NVIDIA driver setup en bekende problemen diff --git a/content/docs/hardware/nvidia-driver-installation.md b/content/docs/hardware/nvidia-driver-installation.md index f1e632a..8061b1b 100644 --- a/content/docs/hardware/nvidia-driver-installation.md +++ b/content/docs/hardware/nvidia-driver-installation.md @@ -1,6 +1,7 @@ --- title: "NVIDIA Driver Installation" -weight: 11 +weight: 1 +prev: docs/getting-started --- The G16 has an NVIDIA RTX 4060 alongside the AMD iGPU. The open-source Nouveau driver doesn't perform well on modern NVIDIA hardware, so proprietary drivers are necessary. @@ -12,14 +13,14 @@ The G16 has an NVIDIA RTX 4060 alongside the AMD iGPU. The open-source Nouveau d ## CachyOS (Arch) -CachyOS ships with NVIDIA drivers pre-installed as part of the installer. If you selected the NVIDIA option during setup, no manual driver installation is needed — the driver is already active and fully configured. +CachyOS automatically detects your hardware during installation and sets up the NVIDIA driver without any manual steps. No selection required; by the time the installer finishes, the driver is already active and fully configured. See [Post-Installation Verification](#post-installation-verification) to confirm everything is working correctly. ## Fedora -The following covers the full manual installation process. I ran into several crashes and lockups during setup that took some time to track down — those are documented on the [Known Issues]({{< relref "/docs/known-issues" >}}) page. +The following covers the full manual installation process. I ran into several crashes and lockups during setup that took some time to track down; those are documented on the [Known Issues]({{< relref "/docs/known-issues" >}}) page. ## Prerequisites @@ -161,13 +162,13 @@ sudo systemctl enable nvidia-hibernate.service nvidia-suspend.service nvidia-res These services prevent GPU state issues after suspend/resume cycles. -**Important: Do NOT enable `nvidia-powerd` — mask it permanently** +**Important: Do NOT enable `nvidia-powerd`; mask it permanently** The `nvidia-powerd.service` manages NVIDIA Dynamic Boost, which shifts extra wattage (~5-15W) from the CPU to the GPU during heavy GPU loads. While useful on Intel-based laptops, it conflicts with AMD ATPX power management on the Zephyrus G16 and causes soft lockups and "GPU has fallen off the bus" errors. On this laptop, GPU power is managed via ATPX (AMD-driven via ACPI). The NVIDIA suspend/hibernate/resume services and `supergfxctl` handle power states correctly without `nvidia-powerd`. -**What you lose by disabling it:** Minimal — a few FPS less during heavy GPU workloads. The ~5-15W Dynamic Boost is not worth the instability on AMD ATPX hardware. +**What you lose by disabling it:** Minimal. A few FPS less during heavy GPU workloads. The ~5-15W Dynamic Boost is not worth the instability on AMD ATPX hardware. **Disable and mask permanently:** ```bash @@ -176,7 +177,7 @@ sudo systemctl stop nvidia-powerd.service sudo systemctl mask nvidia-powerd.service ``` -Masking creates a symlink to `/dev/null`, preventing any process — including NVIDIA driver updates via `dnf` — from re-enabling the service. +Masking creates a symlink to `/dev/null`, preventing any process (including NVIDIA driver updates via `dnf`) from re-enabling the service. **If you want to try re-enabling it later** (e.g., after a kernel or driver update that may fix the ATPX conflict): ```bash @@ -267,7 +268,7 @@ cp GA605WV_1002_104D158E_CMDEF.icm ~/.local/share/icc/ **Note:** If GNOME Settings shows old technical names (e.g., "ASUS GA605WV 1002 104D158E CMDEF" instead of "Native"), close Settings and reopen, or log out/in to refresh the color cache. -The filename encodes your GPU (`1002` = AMD, `10DE` = NVIDIA) and panel ID — match these to your unit using the panel table above. All profiles are in the [`/icc-profiles/`](https://github.com/Stensel8/Zephyrus-Linux/tree/main/static/icc-profiles) directory. +The filename encodes your GPU (`1002` = AMD, `10DE` = NVIDIA) and panel ID. Match these to your unit using the panel table above. All profiles are in the [`/icc-profiles/`](https://github.com/Stensel8/Zephyrus-Linux/tree/main/static/icc-profiles) directory. **Background:** diff --git a/content/docs/hardware/nvidia-driver-installation.nl.md b/content/docs/hardware/nvidia-driver-installation.nl.md index c217c6a..97d852a 100644 --- a/content/docs/hardware/nvidia-driver-installation.nl.md +++ b/content/docs/hardware/nvidia-driver-installation.nl.md @@ -1,6 +1,7 @@ --- title: "NVIDIA Driver Installatie" -weight: 11 +weight: 1 +prev: docs/getting-started --- De G16 heeft een NVIDIA RTX 4060 naast de AMD iGPU. De open-source Nouveau driver werkt niet goed op moderne NVIDIA-hardware, dus proprietary drivers zijn nodig. @@ -12,14 +13,14 @@ De G16 heeft een NVIDIA RTX 4060 naast de AMD iGPU. De open-source Nouveau drive ## CachyOS (Arch) -CachyOS levert NVIDIA drivers standaard mee als onderdeel van de installer. Als je tijdens de installatie voor de NVIDIA-optie hebt gekozen, is de driver al aanwezig en volledig geconfigureerd — handmatige installatie is niet nodig. +CachyOS detecteert je hardware automatisch tijdens de installatie en installeert de NVIDIA-driver zonder handmatige stappen. Je hoeft zelf niets te selecteren; als de installer klaar is, is de driver al actief en volledig geconfigureerd. Ga naar [Verificatie Na Installatie](#verificatie-na-installatie) om te bevestigen dat alles correct werkt. ## Fedora -De volgende stappen behandelen het volledige handmatige installatieproces. Ik liep tijdens de installatie tegen meerdere crashes en lockups aan die wat tijd kostten om op te sporen — die staan gedocumenteerd op de pagina [Bekende Problemen]({{< relref "/docs/known-issues" >}}). +De volgende stappen behandelen het volledige handmatige installatieproces. Ik liep tijdens de installatie tegen meerdere crashes en lockups aan die wat tijd kostten om op te sporen; die staan gedocumenteerd op de pagina [Bekende Problemen]({{< relref "/docs/known-issues" >}}). ## Vereisten @@ -161,13 +162,13 @@ sudo systemctl enable nvidia-hibernate.service nvidia-suspend.service nvidia-res Deze services voorkomen GPU state problemen na suspend/resume cycli. -**Belangrijk: `nvidia-powerd` niet activeren — permanent masken** +**Belangrijk: `nvidia-powerd` niet activeren; permanent masken** De `nvidia-powerd.service` beheert NVIDIA Dynamic Boost, waarmee extra wattage (~5-15W) van de CPU naar de GPU geschoven wordt tijdens zware GPU-belasting. Hoewel nuttig op Intel-gebaseerde laptops, conflicteert het met AMD ATPX power management op de Zephyrus G16 en veroorzaakt soft lockups en "GPU has fallen off the bus" fouten. Op deze laptop wordt GPU-vermogensbeheer geregeld via ATPX (AMD-gestuurd via ACPI). De NVIDIA suspend/hibernate/resume services en `supergfxctl` beheren power states correct zonder `nvidia-powerd`. -**Wat je verliest door het uit te zetten:** Minimaal — een paar FPS minder bij zware GPU workloads. De ~5-15W Dynamic Boost is de instabiliteit niet waard op AMD ATPX hardware. +**Wat je verliest door het uit te zetten:** Minimaal. Een paar FPS minder bij zware GPU workloads. De ~5-15W Dynamic Boost is de instabiliteit niet waard op AMD ATPX hardware. **Uitschakelen en permanent masken:** ```bash @@ -176,7 +177,7 @@ sudo systemctl stop nvidia-powerd.service sudo systemctl mask nvidia-powerd.service ``` -Masken maakt een symlink naar `/dev/null`, waardoor geen enkel proces — ook geen NVIDIA driver updates via `dnf` — de service opnieuw kan activeren. +Masken maakt een symlink naar `/dev/null`, waardoor geen enkel proces (ook geen NVIDIA driver updates via `dnf`) de service opnieuw kan activeren. **Als je het later opnieuw wilt proberen** (bijv. na een kernel- of driver-update die het ATPX-conflict mogelijk verhelpt): ```bash @@ -266,7 +267,7 @@ cp GA605WV_1002_104D158E_CMDEF.icm ~/.local/share/icc/ **Opmerking:** Als GNOME Settings de oude technische namen toont (bijv. "ASUS GA605WV 1002 104D158E CMDEF" in plaats van "Native"), sluit Settings af en heropen, of log uit/in om de color cache te verversen. -De bestandsnaam bevat je GPU (`1002` = AMD, `10DE` = NVIDIA) en paneel-ID — match deze aan jouw exemplaar via de paneeltabel hierboven. Alle profielen staan in de [`/icc-profiles/`](https://github.com/Stensel8/Zephyrus-Linux/tree/main/static/icc-profiles) map. +De bestandsnaam bevat je GPU (`1002` = AMD, `10DE` = NVIDIA) en paneel-ID. Match deze aan jouw exemplaar via de paneeltabel hierboven. Alle profielen staan in de [`/icc-profiles/`](https://github.com/Stensel8/Zephyrus-Linux/tree/main/static/icc-profiles) map. **Achtergrond:** diff --git a/content/docs/hardware/secure-boot.md b/content/docs/hardware/secure-boot.md index 3dfb891..3ca9a5c 100644 --- a/content/docs/hardware/secure-boot.md +++ b/content/docs/hardware/secure-boot.md @@ -1,13 +1,13 @@ --- title: "Secure Boot" -weight: 12 +weight: 2 --- -To install CachyOS, Secure Boot has to be off first. Unlike Ubuntu or Fedora, CachyOS doesn't use shim — a Microsoft-signed bootloader that lets third-party systems boot under Secure Boot. Without it, Secure Boot blocks the CachyOS bootloader before it even starts, so it has to be disabled for installation ([CachyOS installation docs](https://wiki.cachyos.org/installation/installation_on_root/)). +To install CachyOS, Secure Boot has to be off first. Unlike Ubuntu or Fedora, CachyOS doesn't use shim, a Microsoft-signed bootloader that lets third-party systems boot under Secure Boot. Without it, Secure Boot blocks the CachyOS bootloader before it even starts, so it has to be disabled for installation ([CachyOS installation docs](https://wiki.cachyos.org/installation/installation_on_root/)). After installation, it's possible to re-enable it with your own signing keys. This is how I did that using `sbctl`. -> **Result:** UEFI Secure Boot goes from **Fail** to **Pass** after completing this guide. The overall HSI score remains **HSI:3!** — the Encrypted RAM check at HSI-4 is not supported on this hardware, which prevents reaching HSI:4. +> **Result:** UEFI Secure Boot goes from **Fail** to **Pass** after completing this guide. The overall HSI score remains **HSI:3!** (the Encrypted RAM check at HSI-4 is not supported on this hardware, which prevents reaching HSI:4). ## Security Report Context @@ -17,9 +17,9 @@ Running `fwupdmgr security` shows what passes and what doesn't. After enabling S | Test | After this guide | Reason | |---|---|---| | UEFI Secure Boot | ✓ Pass | Fixed by this guide | -| Encrypted RAM (HSI-4) | ✗ Not Supported | Hardware limitation — Ryzen AI 9 HX 370 does not implement AMD SME/TME | -| Linux Kernel Verification | ✗ Tainted | Proprietary NVIDIA driver permanently taints the kernel — expected | -| Linux Kernel Lockdown | ✗ Not Enabled | Requires kernel lockdown mode — not covered here, conflicts with proprietary modules | +| Encrypted RAM (HSI-4) | ✗ Not Supported | Hardware limitation: Ryzen AI 9 HX 370 does not implement AMD SME/TME | +| Linux Kernel Verification | ✗ Tainted | Proprietary NVIDIA driver permanently taints the kernel (expected) | +| Linux Kernel Lockdown | ✗ Not Enabled | Requires kernel lockdown mode, not covered here; conflicts with proprietary modules | ![fwupdmgr security output showing HSI:3 with UEFI Secure Boot disabled](/images/secure-boot-hsi-report.avif) @@ -28,7 +28,7 @@ Running `fwupdmgr security` shows what passes and what doesn't. After enabling S Instead of the shim → MOK → kernel chain that many distributions use, `sbctl` enrolls custom Secure Boot keys directly into the UEFI firmware. The bootloader and kernel EFI images are then signed with those keys. No shim or MOK Manager needed. -`sbctl` also ships with a pacman hook that automatically re-signs all registered EFI binaries after kernel or bootloader updates — so it's not something you have to think about after the initial setup. +`sbctl` also ships with a pacman hook that automatically re-signs all registered EFI binaries after kernel or bootloader updates, so it's not something you have to think about after the initial setup. ## Installation @@ -38,7 +38,7 @@ sudo pacman -S sbctl ``` -## Step 1 — Enter UEFI Setup Mode +## Step 1: Enter UEFI Setup Mode Setup Mode is a UEFI state where no Secure Boot keys are enrolled yet, which allows new ones to be added. You need to get into this state before creating keys. @@ -73,32 +73,32 @@ Secure Boot: ✗ Disabled Vendor Keys: none ``` -`Setup Mode` showing `Enabled` confirms the UEFI is ready for key enrollment. The `✗` symbols aren't errors here — they just mean the keys haven't been set up yet, which is exactly where we want to be at this point. +`Setup Mode` showing `Enabled` confirms the UEFI is ready for key enrollment. The `✗` symbols aren't errors here; they just mean the keys haven't been set up yet, which is exactly where we want to be at this point. -## Step 2 — Create Keys +## Step 2: Create Keys ```bash sudo sbctl create-keys ``` -## Step 3 — Enroll Keys +## Step 3: Enroll Keys -This enrolls the custom keys into the firmware, including Microsoft's UEFI CA certificates. The `--microsoft` flag is required on ASUS hardware — without it, option ROMs (GPU firmware) and other UEFI drivers signed by Microsoft refuse to load. I was a bit hesitant about including Microsoft's certificates here, but without them the system won't boot properly. +This enrolls the custom keys into the firmware, including Microsoft's UEFI CA certificates. The `--microsoft` flag is required on ASUS hardware; without it, option ROMs (GPU firmware) and other UEFI drivers signed by Microsoft refuse to load. I was a bit hesitant about including Microsoft's certificates here, but without them the system won't boot properly. ```bash sudo sbctl enroll-keys --microsoft ``` -## Step 4 — Sign EFI Binaries +## Step 4: Sign EFI Binaries The signing process differs slightly depending on your bootloader. ### systemd-boot -Sign all EFI binaries and register them in sbctl's database. The `-s` flag is important — it ensures files are automatically re-signed after future updates: +Sign all EFI binaries and register them in sbctl's database. The `-s` flag is important; it ensures files are automatically re-signed after future updates: ```bash sudo sbctl verify @@ -129,7 +129,7 @@ sudo limine-update ``` -## Step 5 — Enable Secure Boot +## Step 5: Enable Secure Boot Reboot into the ASUS UEFI again: @@ -165,9 +165,9 @@ Vendor Keys: microsoft fwupdmgr security ``` -The **UEFI Secure Boot** line under HSI-1 should now show **Enabled**. The overall score remains **HSI:3!** — Encrypted RAM at HSI-4 is not supported on this hardware, which is a hardware limitation unrelated to this guide. +The **UEFI Secure Boot** line under HSI-1 should now show **Enabled**. The overall score remains **HSI:3!** (Encrypted RAM at HSI-4 is not supported on this hardware, a hardware limitation unrelated to this guide). -![fwupdmgr security output after enabling Secure Boot — HSI:3! with UEFI Secure Boot now passing under HSI-1](/images/secure-boot-fwupdmgr-after.avif) +![fwupdmgr security output after enabling Secure Boot - HSI:3 with UEFI Secure Boot now passing under HSI-1](/images/secure-boot-fwupdmgr-after.avif) GNOME Settings → Privacy & Security → Device Security also confirms it: @@ -186,7 +186,7 @@ After a kernel update, pacman triggers both: No manual intervention needed after updates. -> **Kernel taint:** The proprietary NVIDIA driver will continue to taint the kernel. This shows as `Linux Kernel Verification: Tainted` in the HSI report. This is expected — it means non-open-source code is loaded, not that the system is compromised. +> **Kernel taint:** The proprietary NVIDIA driver will continue to taint the kernel. This shows as `Linux Kernel Verification: Tainted` in the HSI report. This is expected; it means non-open-source code is loaded, not that the system is compromised. ## Remaining HSI Failures Explained @@ -197,7 +197,7 @@ No manual intervention needed after updates. ### Linux Kernel Lockdown -Kernel lockdown can be enabled by adding `lockdown=integrity` to kernel parameters. However, lockdown restricts unsigned kernel modules and certain privileged operations — the proprietary NVIDIA driver would break under lockdown mode. Not something I'd recommend for day-to-day use on this hardware. +Kernel lockdown can be enabled by adding `lockdown=integrity` to kernel parameters. However, lockdown restricts unsigned kernel modules and certain privileged operations, and the proprietary NVIDIA driver would break under lockdown mode. Not something I'd recommend for day-to-day use on this hardware. ### Linux Kernel Verification (Tainted) diff --git a/content/docs/hardware/secure-boot.nl.md b/content/docs/hardware/secure-boot.nl.md index 61c8d0a..a8ef628 100644 --- a/content/docs/hardware/secure-boot.nl.md +++ b/content/docs/hardware/secure-boot.nl.md @@ -1,13 +1,13 @@ --- title: "Secure Boot" -weight: 12 +weight: 2 --- -Om CachyOS te installeren moet Secure Boot eerst uit. Anders dan Ubuntu of Fedora gebruikt CachyOS geen shim — een door Microsoft ondertekende bootloader waarmee distributies van derden kunnen opstarten onder Secure Boot. Zonder shim blokkeert Secure Boot de CachyOS-bootloader bij het opstarten, waardoor het voor de installatie uitgeschakeld moet worden ([CachyOS installatiedocumentatie](https://wiki.cachyos.org/installation/installation_on_root/)). +Om CachyOS te installeren moet Secure Boot eerst uit. Anders dan Ubuntu of Fedora gebruikt CachyOS geen shim, een door Microsoft ondertekende bootloader waarmee distributies van derden kunnen opstarten onder Secure Boot. Zonder shim blokkeert Secure Boot de CachyOS-bootloader bij het opstarten, waardoor het voor de installatie uitgeschakeld moet worden ([CachyOS installatiedocumentatie](https://wiki.cachyos.org/installation/installation_on_root/)). Na de installatie kan Secure Boot opnieuw worden ingeschakeld met je eigen ondertekeningssleutels. Dit is hoe ik dat heb gedaan met `sbctl`. -> **Resultaat:** UEFI Secure Boot gaat van **Fail** naar **Pass** na het voltooien van deze handleiding. De algehele HSI-score blijft **HSI:3!** — de Encrypted RAM-check op HSI-4 wordt niet ondersteund op deze hardware, waardoor HSI:4 niet haalbaar is. +> **Resultaat:** UEFI Secure Boot gaat van **Fail** naar **Pass** na het voltooien van deze handleiding. De algehele HSI-score blijft **HSI:3!** (de Encrypted RAM-check op HSI-4 wordt niet ondersteund op deze hardware, waardoor HSI:4 niet haalbaar is). ## Context van het beveiligingsrapport @@ -17,9 +17,9 @@ Het uitvoeren van `fwupdmgr security` toont wat slaagt en wat niet. Na het insch | Test | Na deze handleiding | Reden | |---|---|---| | UEFI Secure Boot | ✓ Pass | Opgelost door deze handleiding | -| Encrypted RAM (HSI-4) | ✗ Not Supported | Hardwarebeperking — Ryzen AI 9 HX 370 implementeert AMD SME/TME niet | -| Linux Kernel Verification | ✗ Tainted | Proprietary NVIDIA-driver vervuilt de kernel permanent — verwacht gedrag | -| Linux Kernel Lockdown | ✗ Not Enabled | Vereist kernel lockdown-modus — niet behandeld hier, conflicteert met proprietary modules | +| Encrypted RAM (HSI-4) | ✗ Not Supported | Hardwarebeperking: Ryzen AI 9 HX 370 implementeert AMD SME/TME niet | +| Linux Kernel Verification | ✗ Tainted | Proprietary NVIDIA-driver vervuilt de kernel permanent (verwacht gedrag) | +| Linux Kernel Lockdown | ✗ Not Enabled | Vereist kernel lockdown-modus, niet behandeld hier; conflicteert met proprietary modules | ![fwupdmgr security uitvoer met HSI:3 en UEFI Secure Boot uitgeschakeld](/images/secure-boot-hsi-report.avif) @@ -28,7 +28,7 @@ Het uitvoeren van `fwupdmgr security` toont wat slaagt en wat niet. Na het insch In plaats van de shim → MOK → kernel-keten die veel distributies gebruiken, schrijft `sbctl` aangepaste Secure Boot-sleutels rechtstreeks in de UEFI-firmware in. De bootloader en het kernel EFI-image worden daarna ondertekend met die sleutels. Geen shim of MOK Manager nodig. -`sbctl` wordt ook geleverd met een pacman-hook die alle geregistreerde EFI-binaries automatisch opnieuw ondertekent na kernel- of bootloader-updates — iets wat je na de initiële setup niet meer handmatig hoeft te doen. +`sbctl` wordt ook geleverd met een pacman-hook die alle geregistreerde EFI-binaries automatisch opnieuw ondertekent na kernel- of bootloader-updates, iets wat je na de initiële setup niet meer handmatig hoeft te doen. ## Installatie @@ -38,7 +38,7 @@ sudo pacman -S sbctl ``` -## Stap 1 — UEFI Setup Mode activeren +## Stap 1: UEFI Setup Mode activeren Setup Mode is een UEFI-toestand waarbij er nog geen Secure Boot-sleutels zijn ingeschreven, waardoor nieuwe sleutels kunnen worden toegevoegd. Je moet eerst in deze toestand komen voordat je sleutels aanmaakt. @@ -73,32 +73,32 @@ Secure Boot: ✗ Disabled Vendor Keys: none ``` -`Setup Mode` met de waarde `Enabled` bevestigt dat de UEFI klaar is voor sleutelinschrijving. De `✗`-symbolen zijn hier geen fouten — ze geven alleen aan dat de sleutels nog niet zijn aangemaakt, wat precies de bedoeling is op dit punt. +`Setup Mode` met de waarde `Enabled` bevestigt dat de UEFI klaar is voor sleutelinschrijving. De `✗`-symbolen zijn hier geen fouten; ze geven alleen aan dat de sleutels nog niet zijn aangemaakt, wat precies de bedoeling is op dit punt. -## Stap 2 — Sleutels aanmaken +## Stap 2: Sleutels aanmaken ```bash sudo sbctl create-keys ``` -## Stap 3 — Sleutels inschrijven +## Stap 3: Sleutels inschrijven -Dit schrijft de aangepaste sleutels in de firmware in, inclusief de UEFI CA-certificaten van Microsoft. De `--microsoft`-vlag is vereist op ASUS-hardware — zonder die certificaten weigeren option ROMs (GPU-firmware) en andere UEFI-drivers van Microsoft te laden. Ik aarzelde een beetje om de sleutels van Microsoft mee te nemen, maar zonder die vlag start het systeem niet goed op. +Dit schrijft de aangepaste sleutels in de firmware in, inclusief de UEFI CA-certificaten van Microsoft. De `--microsoft`-vlag is vereist op ASUS-hardware; zonder die certificaten weigeren option ROMs (GPU-firmware) en andere UEFI-drivers van Microsoft te laden. Ik aarzelde een beetje om de sleutels van Microsoft mee te nemen, maar zonder die vlag start het systeem niet goed op. ```bash sudo sbctl enroll-keys --microsoft ``` -## Stap 4 — EFI-binaries ondertekenen +## Stap 4: EFI-binaries ondertekenen Het ondertekeningsproces verschilt iets per bootloader. ### systemd-boot -Onderteken alle EFI-binaries en registreer ze in de sbctl-database. De `-s`-vlag is belangrijk — die zorgt ervoor dat bestanden automatisch opnieuw worden ondertekend na toekomstige updates: +Onderteken alle EFI-binaries en registreer ze in de sbctl-database. De `-s`-vlag is belangrijk; die zorgt ervoor dat bestanden automatisch opnieuw worden ondertekend na toekomstige updates: ```bash sudo sbctl verify @@ -129,7 +129,7 @@ sudo limine-update ``` -## Stap 5 — Secure Boot inschakelen +## Stap 5: Secure Boot inschakelen Herstart opnieuw naar de ASUS UEFI: @@ -165,9 +165,9 @@ Vendor Keys: microsoft fwupdmgr security ``` -De regel **UEFI Secure Boot** onder HSI-1 moet nu **Enabled** tonen. De algehele score blijft **HSI:3!** — Encrypted RAM op HSI-4 wordt niet ondersteund op deze hardware en staat los van deze handleiding. +De regel **UEFI Secure Boot** onder HSI-1 moet nu **Enabled** tonen. De algehele score blijft **HSI:3!** (Encrypted RAM op HSI-4 wordt niet ondersteund op deze hardware, wat los staat van deze handleiding). -![fwupdmgr security uitvoer na het inschakelen van Secure Boot — HSI:3! met UEFI Secure Boot nu geslaagd onder HSI-1](/images/secure-boot-fwupdmgr-after.avif) +![fwupdmgr security uitvoer na het inschakelen van Secure Boot - HSI:3 met UEFI Secure Boot nu geslaagd onder HSI-1](/images/secure-boot-fwupdmgr-after.avif) GNOME Instellingen → Privacy & Beveiliging → Apparaatbeveiliging bevestigt ook het resultaat: @@ -186,7 +186,7 @@ Na een kernelupdate activeert pacman beide: Na updates is geen handmatige actie nodig. -> **Kernelvervuiling:** De proprietary NVIDIA-driver zal de kernel blijven vervuilen. Dit verschijnt als `Linux Kernel Verification: Tainted` in het HSI-rapport. Dit is verwacht — het betekent dat niet-open-source code is geladen, niet dat het systeem is aangetast. +> **Kernelvervuiling:** De proprietary NVIDIA-driver zal de kernel blijven vervuilen. Dit verschijnt als `Linux Kernel Verification: Tainted` in het HSI-rapport. Dit is verwacht; het betekent dat niet-open-source code is geladen, niet dat het systeem is aangetast. ## Overgebleven HSI-fouten uitgelegd @@ -197,7 +197,7 @@ Na updates is geen handmatige actie nodig. ### Linux Kernel Lockdown -Kernel lockdown kan worden ingeschakeld door `lockdown=integrity` toe te voegen aan de kernelparameters. Lockdown beperkt echter niet-ondertekende kernelmodules en bepaalde bevoorrechte bewerkingen — de proprietary NVIDIA-driver zou niet werken onder lockdown-modus. Niet iets wat ik zou aanraden voor dagelijks gebruik op deze hardware. +Kernel lockdown kan worden ingeschakeld door `lockdown=integrity` toe te voegen aan de kernelparameters. Lockdown beperkt echter niet-ondertekende kernelmodules en bepaalde bevoorrechte bewerkingen, en de proprietary NVIDIA-driver zou niet werken onder lockdown-modus. Niet iets wat ik zou aanraden voor dagelijks gebruik op deze hardware. ### Linux Kernel Verification (Tainted) diff --git a/content/docs/known-issues.md b/content/docs/known-issues.md index dadd5cb..7201698 100644 --- a/content/docs/known-issues.md +++ b/content/docs/known-issues.md @@ -1,13 +1,14 @@ --- title: "Known Issues" -weight: 99 +weight: 7 +prev: docs/virtualization/looking-glass-attempt --- Central reference for hardware and software issues on the ASUS ROG Zephyrus G16 GA605WV. Active issues are listed first. Resolved issues are kept as reference at the bottom. ## Active Issues -### Brave Browser — touchpad scrolling too fast on Wayland +### Brave Browser: touchpad scrolling too fast on Wayland **What's happening:** Touchpad scrolling in Brave feels significantly faster than in Firefox or native GTK apps. A short swipe sends the page flying. This affects all Chromium-based browsers on Wayland. @@ -19,11 +20,11 @@ Upstream Chromium issue. Chromium receives high-precision scroll events from lib Open. No fix in Brave as of early 2026. The issue has been reported since at least 2022. **Attempted workaround (abandoned):** -Lowering the global `scroll-factor` in [libinput-config]({{< relref "/docs/applications#touchpad-scroll-speed--no-native-gnome-setting-yet" >}}) does reduce scrolling speed in Brave, but it's a system-wide change — it affects every application, including ones where scrolling was already fine. After running with this for about a week I removed it. The Brave-specific problem doesn't justify slowing down everything else. +Lowering the global `scroll-factor` in [libinput-config]({{< relref "/docs/applications#touchpad-scroll-speed-no-native-gnome-setting-yet" >}}) does reduce scrolling speed in Brave, but it's a system-wide change that affects every application, including ones where scrolling was already fine. After running with this for about a week I removed it. The Brave-specific problem doesn't justify slowing down everything else. **Sources:** -- [brave-browser #36569 — native touchpad scrolling on Linux Wayland](https://github.com/brave/brave-browser/issues/36569) -- [Brave Community — high-resolution touchpad scrolling on Linux Wayland](https://community.brave.app/t/scrolling-speed-is-way-too-fast/649357) +- [brave-browser #36569: native touchpad scrolling on Linux Wayland](https://github.com/brave/brave-browser/issues/36569) +- [Brave Community: high-resolution touchpad scrolling on Linux Wayland](https://community.brave.app/t/scrolling-speed-is-way-too-fast/649357) --- @@ -80,7 +81,7 @@ If no `amdgpu: [drm] *ERROR*` messages appear, the fix is working. {{% /details %}} -{{% details title="System freezes during VS Code use (AMD GPU page fault — Kernel 6.18.x)" closed="true" %}} +{{% details title="System freezes during VS Code use (AMD GPU page fault, Kernel 6.18.x)" closed="true" %}} **What's happening:** System freezes completely during VS Code use. Kernel 6.18.x/6.19.x have critical amdgpu driver bugs. VS Code hardware acceleration triggers AMD Radeon 890M page fault → complete freeze. @@ -101,7 +102,7 @@ Restart VS Code. System stays stable, VS Code slightly slower but perfectly usab {{% /details %}} -{{% details title="System freezes during Brave Browser use (AMD GPU page fault — Kernel 6.18.x)" closed="true" %}} +{{% details title="System freezes during Brave Browser use (AMD GPU page fault, Kernel 6.18.x)" closed="true" %}} **What's happening:** System freezes or crashes during Brave Browser use, even with minimal workload (a few tabs). Chromium-based applications with hardware acceleration trigger AMD Radeon 890M page faults on kernel 6.18.x/6.19.x. @@ -155,7 +156,7 @@ This can occur due to a combination of factors on hybrid GPU laptops: **Additional symptom: Reboot hang (black screen, backlights stay on)** -The system appears to shut down but never completes the hardware reset — the screen goes black but keyboard and screen backlights remain on. This occurs when `nvidia-powerd` interferes with ACPI power state transitions during shutdown/reboot. +The system appears to shut down but never completes the hardware reset; the screen goes black but keyboard and screen backlights remain on. This occurs when `nvidia-powerd` interferes with ACPI power state transitions during shutdown/reboot. **Root cause: `supergfxd` starts `nvidia-powerd` behind your back** @@ -184,7 +185,7 @@ watchdog: watchdog0: watchdog did not stop! **Fix:** -1. Disable and **mask** `nvidia-powerd` (masking is essential — `disable` alone is not enough because `supergfxd` bypasses it): +1. Disable and **mask** `nvidia-powerd` (masking is essential, `disable` alone is not enough because `supergfxd` bypasses it): ```bash sudo systemctl disable nvidia-powerd.service sudo systemctl stop nvidia-powerd.service @@ -209,7 +210,7 @@ On laptops with AMD iGPU + NVIDIA dGPU, the ATPX framework (via ACPI) controls w ## NVIDIA Driver -> These entries apply primarily to the Fedora installation path. CachyOS users are not affected — the driver is pre-configured during installation. +> These entries apply primarily to the Fedora installation path. CachyOS users are not affected; the driver is pre-configured during installation. {{% details title="nvidia-smi: command not found or fails" closed="true" %}} @@ -299,7 +300,7 @@ sed -i \ ~/.local/share/applications/brave-browser.desktop ``` -Verify — you should see exactly three `Exec=` lines with the flag appended: +Verify: you should see exactly three `Exec=` lines with the flag appended: ```bash grep "^Exec" ~/.local/share/applications/brave-browser.desktop ``` @@ -318,12 +319,12 @@ Go to `brave://flags` and disable: - **Hardware-accelerated video decode** → `Disabled` -![brave://flags — Hardware-accelerated video decode disabled](/images/brave-flags.avif) +![brave://flags - Hardware-accelerated video decode disabled](/images/brave-flags.avif) After this, `brave://gpu` will show: - `Video Decode: Software only. Hardware acceleration disabled` -![brave://gpu — Video Decode disabled, software only](/images/brave-gpu-config.avif) +![brave://gpu - Video Decode disabled, software only](/images/brave-gpu-config.avif) Brave is slightly slower on video-heavy pages but stable. Hardware video decode is not yet stable on the AMD Radeon 890M with GNOME Wayland. @@ -331,12 +332,16 @@ Brave is slightly slower on video-heavy pages but stable. Hardware video decode {{% details title="Steam won't launch" closed="true" %}} -Start Steam with an additional environment variable: +**What was happening:** +Steam failed to launch on some setups, with no visible error output. + +**Workaround (no longer needed):** ```bash __GL_CONSTANT_FRAME_RATE_HINT=3 steam ``` -If this resolves the issue, you can add this flag permanently via the Steam desktop entry or a wrapper script. +**Resolution:** +This issue has since resolved itself. Steam now launches normally; the `__GL_CONSTANT_FRAME_RATE_HINT` workaround is no longer required. Install Steam from the [CachyOS repository](https://packages.cachyos.org/package/cachyos/x86_64/steam) via `sudo pacman -S steam`. {{% /details %}} @@ -357,7 +362,7 @@ Verify the driver is loaded: lsmod | grep asus_armoury ``` -If it loads, reopen ROG Control Center — the warning should be gone and advanced features will be available. +If it loads, reopen ROG Control Center; the warning should be gone and advanced features will be available. {{% /details %}} diff --git a/content/docs/known-issues.nl.md b/content/docs/known-issues.nl.md index ad53eec..47917c2 100644 --- a/content/docs/known-issues.nl.md +++ b/content/docs/known-issues.nl.md @@ -1,13 +1,14 @@ --- title: "Bekende Problemen" -weight: 99 +weight: 7 +prev: docs/virtualization/looking-glass-attempt --- Centrale referentie voor hardware- en softwareproblemen op de ASUS ROG Zephyrus G16 GA605WV. Actieve problemen staan bovenaan. Opgeloste problemen staan onderaan als naslagwerk. ## Actieve Problemen -### Brave Browser — touchpad scrollt te snel op Wayland +### Brave Browser: touchpad scrollt te snel op Wayland **Wat er gebeurt:** Scrollen met het touchpad in Brave voelt aanzienlijk sneller aan dan in Firefox of native GTK-apps. Een korte veegbeweging stuurt de pagina al ver naar beneden. Dit treft alle Chromium-gebaseerde browsers op Wayland. @@ -19,11 +20,11 @@ Upstream Chromium-probleem. Chromium ontvangt hoge-precisie scroll-events van li Open. Geen fix in Brave tot begin 2026. Het probleem wordt al gemeld sinds minimaal 2022. **Geprobeerde workaround (afgebroken):** -Het verlagen van de globale `scroll-factor` in [libinput-config]({{< relref "/docs/applications#touchpad-scroll-speed--no-native-gnome-setting-yet" >}}) vermindert de scrollsnelheid in Brave, maar het is een systeembrede instelling — het beïnvloedt elke applicatie, inclusief apps waar scrollen al prima werkte. Na ongeveer een week verwijderd. Het Brave-specifieke probleem rechtvaardigt niet dat alles trager scrollt. +Het verlagen van de globale `scroll-factor` in [libinput-config]({{< relref "/docs/applications#touchpad-scroll-speed-no-native-gnome-setting-yet" >}}) vermindert de scrollsnelheid in Brave, maar het is een systeembrede instelling die elke applicatie beïnvloedt, inclusief apps waar scrollen al prima werkte. Na ongeveer een week verwijderd. Het Brave-specifieke probleem rechtvaardigt niet dat alles trager scrollt. **Bronnen:** -- [brave-browser #36569 — native touchpad scrolling op Linux Wayland](https://github.com/brave/brave-browser/issues/36569) -- [Brave Community — hoge-resolutie touchpad scrolling op Linux Wayland](https://community.brave.app/t/scrolling-speed-is-way-too-fast/649357) +- [brave-browser #36569: native touchpad scrolling op Linux Wayland](https://github.com/brave/brave-browser/issues/36569) +- [Brave Community: hoge-resolutie touchpad scrolling op Linux Wayland](https://community.brave.app/t/scrolling-speed-is-way-too-fast/649357) --- @@ -80,7 +81,7 @@ Als er geen `amdgpu: [drm] *ERROR*`-berichten verschijnen, werkt de fix. {{% /details %}} -{{% details title="Systeem bevriest tijdens gebruik van VS Code (AMD GPU page fault — Kernel 6.18.x)" closed="true" %}} +{{% details title="Systeem bevriest tijdens gebruik van VS Code (AMD GPU page fault, Kernel 6.18.x)" closed="true" %}} **Wat speelt er:** Systeem bevriest volledig tijdens het gebruik van VS Code. Kernel 6.18.x/6.19.x hebben kritieke amdgpu-driverbugs. VS Code hardware-acceleratie triggert een AMD Radeon 890M page fault → volledige bevriezing. @@ -101,7 +102,7 @@ Herstart VS Code. Systeem blijft nu stabiel, VS Code iets langzamer maar prima b {{% /details %}} -{{% details title="Systeem bevriest tijdens gebruik van Brave Browser (AMD GPU page fault — Kernel 6.18.x)" closed="true" %}} +{{% details title="Systeem bevriest tijdens gebruik van Brave Browser (AMD GPU page fault, Kernel 6.18.x)" closed="true" %}} **Wat speelt er:** Systeem bevriest of crasht tijdens het gebruik van Brave Browser, zelfs bij minimale workload (enkele tabs). Chromium-gebaseerde applicaties met hardware-acceleratie triggeren AMD Radeon 890M page faults op kernel 6.18.x/6.19.x. @@ -155,7 +156,7 @@ Dit kan optreden door een combinatie van factoren op hybrid GPU-laptops: **Extra symptoom: Reboot hangt (zwart scherm, verlichting blijft aan)** -Het systeem lijkt af te sluiten maar voltooit de hardware-reset niet — het scherm wordt zwart maar toetsenbord- en schermverlichting blijven aan. Dit gebeurt wanneer `nvidia-powerd` interfereert met ACPI power state-overgangen tijdens afsluiten/herstarten. +Het systeem lijkt af te sluiten maar voltooit de hardware-reset niet; het scherm wordt zwart maar toetsenbord- en schermverlichting blijven aan. Dit gebeurt wanneer `nvidia-powerd` interfereert met ACPI power state-overgangen tijdens afsluiten/herstarten. **Oorzaak: `supergfxd` start `nvidia-powerd` achter je rug om** @@ -184,7 +185,7 @@ watchdog: watchdog0: watchdog did not stop! **Fix:** -1. Disable én **mask** `nvidia-powerd` (masken is essentieel — `disable` alleen is niet genoeg omdat `supergfxd` het omzeilt): +1. Disable én **mask** `nvidia-powerd` (masken is essentieel, `disable` alleen is niet genoeg omdat `supergfxd` het omzeilt): ```bash sudo systemctl disable nvidia-powerd.service sudo systemctl stop nvidia-powerd.service @@ -209,7 +210,7 @@ Op laptops met AMD iGPU + NVIDIA dGPU regelt het ATPX-framework (via ACPI) welke ## NVIDIA Driver -> Deze onderdelen gelden voornamelijk voor de Fedora-installatieroute. CachyOS-gebruikers worden hier niet door getroffen — de driver is tijdens de installatie al vooraf geconfigureerd. +> Deze onderdelen gelden voornamelijk voor de Fedora-installatieroute. CachyOS-gebruikers worden hier niet door getroffen; de driver is tijdens de installatie al vooraf geconfigureerd. {{% details title="nvidia-smi: command not found of mislukt" closed="true" %}} @@ -299,7 +300,7 @@ sed -i \ ~/.local/share/applications/brave-browser.desktop ``` -Verifieer — je zou exact drie `Exec=`-regels moeten zien met de flag toegevoegd: +Verifieer dit: je zou exact drie `Exec=`-regels moeten zien met de flag toegevoegd: ```bash grep "^Exec" ~/.local/share/applications/brave-browser.desktop ``` @@ -318,12 +319,12 @@ Ga naar `brave://flags` en schakel uit: - **Hardware-accelerated video decode** → `Disabled` -![brave://flags — Hardware-accelerated video decode uitgeschakeld](/images/brave-flags.avif) +![brave://flags - Hardware-accelerated video decode uitgeschakeld](/images/brave-flags.avif) Daarna toont `brave://gpu`: - `Video Decode: Software only. Hardware acceleration disabled` -![brave://gpu — Video Decode uitgeschakeld, software only](/images/brave-gpu-config.avif) +![brave://gpu - Video Decode uitgeschakeld, software only](/images/brave-gpu-config.avif) Brave is iets langzamer op video-intensieve pagina's maar stabiel. Hardware video decode is nog niet stabiel op de AMD Radeon 890M met GNOME Wayland. @@ -331,12 +332,16 @@ Brave is iets langzamer op video-intensieve pagina's maar stabiel. Hardware vide {{% details title="Steam wil niet starten" closed="true" %}} -Start Steam met een extra omgevingsvariabele: +**Wat er speelde:** +Steam startte op sommige systemen niet op, zonder zichtbare foutmelding. + +**Workaround (niet meer nodig):** ```bash __GL_CONSTANT_FRAME_RATE_HINT=3 steam ``` -Als dit werkt, kun je deze flag permanent toevoegen via de Steam desktop-entry of een wrapper-script. +**Oplossing:** +Dit probleem heeft zichzelf opgelost. Steam start nu gewoon op; de `__GL_CONSTANT_FRAME_RATE_HINT` workaround is niet meer nodig. Installeer Steam vanuit de [CachyOS-repository](https://packages.cachyos.org/package/cachyos/x86_64/steam) via `sudo pacman -S steam`. {{% /details %}} @@ -357,7 +362,7 @@ Verifieer dat de driver is geladen: lsmod | grep asus_armoury ``` -Als hij laadt, heropen ROG Control Center — de melding zou verdwenen moeten zijn en geavanceerde functies zijn beschikbaar. +Als hij laadt, heropen ROG Control Center; de melding zou verdwenen moeten zijn en geavanceerde functies zijn beschikbaar. {{% /details %}} diff --git a/content/docs/networking/_index.md b/content/docs/networking/_index.md index c9e7a09..27ae312 100644 --- a/content/docs/networking/_index.md +++ b/content/docs/networking/_index.md @@ -1,6 +1,6 @@ --- title: "Networking" -weight: 30 +weight: 5 toc: false --- diff --git a/content/docs/networking/_index.nl.md b/content/docs/networking/_index.nl.md index cbda8e0..bafab74 100644 --- a/content/docs/networking/_index.nl.md +++ b/content/docs/networking/_index.nl.md @@ -1,6 +1,6 @@ --- title: "Netwerk" -weight: 30 +weight: 5 toc: false --- diff --git a/content/docs/networking/eduroam-network-installation.md b/content/docs/networking/eduroam-network-installation.md index 9f3abd9..e409df0 100644 --- a/content/docs/networking/eduroam-network-installation.md +++ b/content/docs/networking/eduroam-network-installation.md @@ -1,9 +1,11 @@ --- title: "eduroam Network Installation" -weight: 23 +weight: 1 +prev: docs/applications +next: docs/virtualization/vm-setup --- -Getting eduroam to work on Linux is more painful than it should be. Every "official" method I tried failed — the connection would just hang during the TLS handshake and never connect. I eventually figured out a manual setup that works reliably and wrote a script around it. Sharing it here so you hopefully don't have to go through the same process. +Getting eduroam to work on Linux is more painful than it should be. Every "official" method I tried failed; the connection would just hang during the TLS handshake and never connect. I eventually figured out a manual setup that works reliably and wrote a script around it. Sharing it here so you hopefully don't have to go through the same process. ## What doesn't work @@ -28,7 +30,7 @@ The guide at [linux.datanose.nl](https://linux.datanose.nl/linux/eduroam/) (UvA/ ## What does work -PEAP/MSCHAPv2 with CA validation via the system trust store and `domain-suffix-match` — the modern replacement for the deprecated `altsubject-matches`. +PEAP/MSCHAPv2 with CA validation via the system trust store and `domain-suffix-match` (the modern replacement for the deprecated `altsubject-matches`). **Requirements:** - Python 3.10+ @@ -57,7 +59,7 @@ curl -LO https://zephyrus-linux.stensel.nl/scripts/saxion-eduroam.py python3 saxion-eduroam.py ``` -The script removes any existing eduroam profile, prompts for your **username** via a GUI dialog (zenity, kdialog, or yad) or terminal fallback, and activates the connection. Your password is never asked by the script — it is requested by your GNOME Keyring at connection time and stored securely, never in plaintext. +The script removes any existing eduroam profile, prompts for your **username** via a GUI dialog (zenity, kdialog, or yad) or terminal fallback, and activates the connection. Your password is never asked by the script; it is requested by your GNOME Keyring at connection time and stored securely, never in plaintext. {{< callout type="warning" >}} You are downloading and running a script from the internet. If you want to be extra safe, verify the script source (or its checksum) before running it. diff --git a/content/docs/networking/eduroam-network-installation.nl.md b/content/docs/networking/eduroam-network-installation.nl.md index addbc58..e5ea3b8 100644 --- a/content/docs/networking/eduroam-network-installation.nl.md +++ b/content/docs/networking/eduroam-network-installation.nl.md @@ -1,9 +1,11 @@ --- title: "eduroam Netwerkinstallatie" -weight: 23 +weight: 1 +prev: docs/applications +next: docs/virtualization/vm-setup --- -eduroam werkend krijgen op Linux is pijnlijker dan het zou moeten zijn. Elke "officiële" methode die ik probeerde faalde — de verbinding bleef gewoon hangen tijdens de TLS-handshake en verbond nooit. Uiteindelijk heb ik een handmatige setup gevonden die betrouwbaar werkt en daar een script omheen geschreven. Ik deel het hier zodat jij hopelijk niet hetzelfde proces hoeft door te maken. +eduroam werkend krijgen op Linux is pijnlijker dan het zou moeten zijn. Elke "officiële" methode die ik probeerde faalde; de verbinding bleef gewoon hangen tijdens de TLS-handshake en verbond nooit. Uiteindelijk heb ik een handmatige setup gevonden die betrouwbaar werkt en daar een script omheen geschreven. Ik deel het hier zodat jij hopelijk niet hetzelfde proces hoeft door te maken. ## Wat niet werkt @@ -28,7 +30,7 @@ De handleiding op [linux.datanose.nl](https://linux.datanose.nl/linux/eduroam/) ## Wat wel werkt -PEAP/MSCHAPv2 met CA-validatie via de systeem-truststore en `domain-suffix-match` — de moderne vervanging voor het verouderde `altsubject-matches`. +PEAP/MSCHAPv2 met CA-validatie via de systeem-truststore en `domain-suffix-match` (de moderne vervanging voor het verouderde `altsubject-matches`). **Vereisten:** - Python 3.10+ @@ -57,7 +59,7 @@ curl -LO https://zephyrus-linux.stensel.nl/scripts/saxion-eduroam.py python3 saxion-eduroam.py ``` -Het script verwijdert een eventueel bestaand eduroam-profiel, vraagt je **gebruikersnaam** via een GUI-dialoog (zenity, kdialog of yad) of terminal-fallback, en activeert de verbinding. Je wachtwoord wordt nooit door het script gevraagd — dat wordt bij het verbinden opgevraagd door je GNOME Keyring en veilig opgeslagen, nooit in platte tekst. +Het script verwijdert een eventueel bestaand eduroam-profiel, vraagt je **gebruikersnaam** via een GUI-dialoog (zenity, kdialog of yad) of terminal-fallback, en activeert de verbinding. Je wachtwoord wordt nooit door het script gevraagd; dat wordt bij het verbinden opgevraagd door je GNOME Keyring en veilig opgeslagen, nooit in platte tekst. {{< callout type="warning" >}} Je downloadt en voert een script uit vanaf het internet. Wil je extra veilig zijn, verifieer dan de bron (of checksum) voordat je het uitvoert. diff --git a/content/docs/security/_index.md b/content/docs/security/_index.md index ea2c51d..9fca1fa 100644 --- a/content/docs/security/_index.md +++ b/content/docs/security/_index.md @@ -1,6 +1,6 @@ --- title: "Security & Privacy" -weight: 20 +weight: 3 toc: false --- diff --git a/content/docs/security/_index.nl.md b/content/docs/security/_index.nl.md index 7a1ba86..39dfe63 100644 --- a/content/docs/security/_index.nl.md +++ b/content/docs/security/_index.nl.md @@ -1,6 +1,6 @@ --- title: "Beveiliging & Privacy" -weight: 20 +weight: 3 toc: false --- diff --git a/content/docs/security/autologin.md b/content/docs/security/autologin.md index 3262836..059bf1c 100644 --- a/content/docs/security/autologin.md +++ b/content/docs/security/autologin.md @@ -1,9 +1,10 @@ --- title: "GDM Autologin" -weight: 19 +weight: 1 +prev: docs/hardware/asusctl-rog-control --- -After unlocking the disk with LUKS at boot, I didn't want to type a second password to log in to the desktop. This skips the GDM login screen entirely — you enter your disk password once, and the desktop loads straight away. The screen lock still requires your password as normal. +After unlocking the disk with LUKS at boot, I didn't want to type a second password to log in to the desktop. This skips the GDM login screen entirely: you enter your disk password once, and the desktop loads straight away. The screen lock still requires your password as normal. **Boot behavior:** - Power on → LUKS password prompt → desktop (no second login) diff --git a/content/docs/security/autologin.nl.md b/content/docs/security/autologin.nl.md index bfd6bf3..df03054 100644 --- a/content/docs/security/autologin.nl.md +++ b/content/docs/security/autologin.nl.md @@ -1,9 +1,10 @@ --- title: "GDM Autologin" -weight: 19 +weight: 1 +prev: docs/hardware/asusctl-rog-control --- -Na het ontgrendelen van de schijf met LUKS bij het opstarten wilde ik niet nog een keer een wachtwoord invoeren om in te loggen. Dit slaat het GDM-inlogscherm volledig over — je voert je schijfwachtwoord één keer in en het bureaublad laadt direct. De schermvergrendeling vraagt gewoon nog steeds om je wachtwoord. +Na het ontgrendelen van de schijf met LUKS bij het opstarten wilde ik niet nog een keer een wachtwoord invoeren om in te loggen. Dit slaat het GDM-inlogscherm volledig over: je voert je schijfwachtwoord één keer in en het bureaublad laadt direct. De schermvergrendeling vraagt gewoon nog steeds om je wachtwoord. **Bootgedrag:** - Opstarten → LUKS-wachtwoordprompt → bureaublad (geen tweede inlog) diff --git a/content/docs/security/yubikey.md b/content/docs/security/yubikey.md index 1afa003..302879a 100644 --- a/content/docs/security/yubikey.md +++ b/content/docs/security/yubikey.md @@ -1,9 +1,10 @@ --- title: "YubiKey 5C NFC" -weight: 20 +weight: 2 +next: docs/applications --- -I wanted to use my YubiKey to unlock the LUKS-encrypted drive at boot — plug it in, touch it, and the desktop loads. This page documents what I tried, why it failed at first, and what actually works in the meantime. +I wanted to use my YubiKey to unlock the LUKS-encrypted drive at boot: plug it in, touch it, and the desktop loads. This page documents what I tried, why it failed at first, and what actually works in the meantime. > **Status:** LUKS unlock with FIDO2 has been unreliable on systemd 258. This page documents what was attempted, what the root cause is, and what to do instead. The situation may improve with systemd 259+. @@ -12,10 +13,10 @@ I wanted to use my YubiKey to unlock the LUKS-encrypted drive at boot — plug i The YubiKey works reliably for everything **outside** of early boot: -- **OATH/TOTP** — Yubico Authenticator Flatpak 7.3.0 works perfectly for 2FA codes -- **SSH** — FIDO2-backed SSH keys -- **Bitwarden** — hardware-backed authentication -- **pam-u2f** — YubiKey touch for `sudo` and GDM screen unlock (see below) +- **OATH/TOTP**: Yubico Authenticator Flatpak 7.3.0 works perfectly for 2FA codes +- **SSH**: FIDO2-backed SSH keys +- **Bitwarden**: hardware-backed authentication +- **pam-u2f**: YubiKey touch for `sudo` and GDM screen unlock (see below) ## What Was Attempted: FIDO2 LUKS Unlock @@ -57,13 +58,13 @@ add_dracutmodules+=" fido2 " ### What failed -1. **Touch window is ~1-2 seconds** — not enough time to react. There is no configurable `token-timeout=` in crypttab until systemd 259. +1. **Touch window is ~1-2 seconds**: not enough time to react. There is no configurable `token-timeout=` in crypttab until systemd 259. -2. **No password fallback** — when FIDO2 fails, the system does not fall back to asking for a LUKS password. It drops into a dracut emergency shell with a locked root account. This is a confirmed regression introduced in **systemd 257** (issue [#35393](https://github.com/systemd/systemd/issues/35393)). +2. **No password fallback**: when FIDO2 fails, the system does not fall back to asking for a LUKS password. It drops into a dracut emergency shell with a locked root account. This is a confirmed regression introduced in **systemd 257** (issue [#35393](https://github.com/systemd/systemd/issues/35393)). -3. **dracut initqueue races the YubiKey** — the USB HID device is not ready within the 5-second dracut initqueue window on this hardware, so `systemd-cryptsetup` fails before it can even show the touch prompt. +3. **dracut initqueue races the YubiKey**: the USB HID device is not ready within the 5-second dracut initqueue window on this hardware, so `systemd-cryptsetup` fails before it can even show the touch prompt. -4. **rhgb/plymouth swallows prompts** — even with verbose boot, the touch prompt is hidden behind Plymouth. +4. **rhgb/plymouth swallows prompts**: even with verbose boot, the touch prompt is hidden behind Plymouth. ### Root cause @@ -91,7 +92,7 @@ sudo dracut --force --regenerate-all Wait for **systemd 259+** to become available. Systemd 259 adds `token-timeout=` as a proper crypttab option, which gives a configurable wait window for the touch prompt. Combined with a fix for the fallback regression, FIDO2 LUKS unlock should become reliable on CachyOS as well. -When retrying, the enrollment procedure itself is correct — only the systemd version is the blocker. +When retrying, the enrollment procedure itself is correct; only the systemd version is the blocker. ## Using the YubiKey for sudo and Screen Unlock (pam-u2f) diff --git a/content/docs/security/yubikey.nl.md b/content/docs/security/yubikey.nl.md index 656ccd8..39ea2ec 100644 --- a/content/docs/security/yubikey.nl.md +++ b/content/docs/security/yubikey.nl.md @@ -1,9 +1,10 @@ --- title: "YubiKey 5C NFC" -weight: 20 +weight: 2 +next: docs/applications --- -Ik wilde mijn YubiKey gebruiken om de LUKS-schijfversleuteling bij het opstarten te ontgrendelen — inpluggen, aanraken, en het bureaublad laadt. Op deze pagina staat wat ik geprobeerd heb, waarom het aanvankelijk niet werkte, en wat er in de tussentijd wél werkt. +Ik wilde mijn YubiKey gebruiken om de LUKS-schijfversleuteling bij het opstarten te ontgrendelen: inpluggen, aanraken, en het bureaublad laadt. Op deze pagina staat wat ik geprobeerd heb, waarom het aanvankelijk niet werkte, en wat er in de tussentijd wél werkt. > **Status:** LUKS ontgrendeling met FIDO2 is onbetrouwbaar geweest op systemd 258. Deze pagina documenteert wat geprobeerd is, wat de oorzaak is, en wat je in de tussentijd kunt doen. De situatie kan verbeteren met systemd 259+. @@ -12,10 +13,10 @@ Ik wilde mijn YubiKey gebruiken om de LUKS-schijfversleuteling bij het opstarten De YubiKey werkt betrouwbaar voor alles **buiten** de vroege bootprocessen: -- **OATH/TOTP** — Yubico Authenticator Flatpak 7.3.0 werkt uitstekend voor 2FA codes -- **SSH** — FIDO2-backed SSH sleutels -- **Bitwarden** — hardware-backed authenticatie -- **pam-u2f** — YubiKey touch voor `sudo` en GDM-schermvergrendeling (zie hieronder) +- **OATH/TOTP**: Yubico Authenticator Flatpak 7.3.0 werkt uitstekend voor 2FA codes +- **SSH**: FIDO2-backed SSH sleutels +- **Bitwarden**: hardware-backed authenticatie +- **pam-u2f**: YubiKey touch voor `sudo` en GDM-schermvergrendeling (zie hieronder) ## Wat Geprobeerd Is: FIDO2 LUKS Ontgrendeling @@ -57,13 +58,13 @@ add_dracutmodules+=" fido2 " ### Wat niet werkte -1. **Touch venster is ~1-2 seconden** — niet genoeg tijd om te reageren. Er is geen configureerbare `token-timeout=` in crypttab tot systemd 259 uit is. +1. **Touch venster is ~1-2 seconden**: niet genoeg tijd om te reageren. Er is geen configureerbare `token-timeout=` in crypttab tot systemd 259 uit is. -2. **Geen wachtwoord fallback** — als FIDO2 mislukt, vraagt het systeem niet om een LUKS-wachtwoord. Het valt terug in een dracut emergency shell met een vergrendeld root account. Dit is een bevestigde regressie geïntroduceerd in **systemd 257** (issue [#35393](https://github.com/systemd/systemd/issues/35393)). Dit wil je niet. +2. **Geen wachtwoord fallback**: als FIDO2 mislukt, vraagt het systeem niet om een LUKS-wachtwoord. Het valt terug in een dracut emergency shell met een vergrendeld root account. Dit is een bevestigde regressie geïntroduceerd in **systemd 257** (issue [#35393](https://github.com/systemd/systemd/issues/35393)). Dit wil je niet. -3. **dracut initqueue race met de YubiKey** — het USB HID apparaat is niet gereed binnen het 5-seconden dracut initqueue venster op deze hardware, waardoor `systemd-cryptsetup` mislukt voordat het de touch prompt kan tonen. +3. **dracut initqueue race met de YubiKey**: het USB HID apparaat is niet gereed binnen het 5-seconden dracut initqueue venster op deze hardware, waardoor `systemd-cryptsetup` mislukt voordat het de touch prompt kan tonen. -4. **rhgb/plymouth verbergt prompts** — zelfs met verbose boot is de touch prompt verborgen achter Plymouth. +4. **rhgb/plymouth verbergt prompts**: zelfs met verbose boot is de touch prompt verborgen achter Plymouth. ### Oorzaak @@ -91,7 +92,7 @@ sudo dracut --force --regenerate-all Wachten op **systemd 259+**. Systemd 259 voegt `token-timeout=` toe als crypttab optie, wat een configureerbaar wachtvenster geeft voor de touch prompt. Gecombineerd met een fix voor de fallback regressie zou FIDO2 LUKS ontgrendeling ook op CachyOS betrouwbaar moeten worden. -Bij een nieuwe poging is de enrollment procedure zelf correct — alleen de systemd versie is het obstakel op dit moment. +Bij een nieuwe poging is de enrollment procedure zelf correct; alleen de systemd versie is het obstakel op dit moment. ## YubiKey Gebruiken voor sudo en Schermvergrendeling (pam-u2f) diff --git a/content/docs/virtualization/_index.md b/content/docs/virtualization/_index.md index 3227ac5..67cd535 100644 --- a/content/docs/virtualization/_index.md +++ b/content/docs/virtualization/_index.md @@ -1,6 +1,6 @@ --- title: "Virtualization" -weight: 40 +weight: 6 toc: false --- diff --git a/content/docs/virtualization/_index.nl.md b/content/docs/virtualization/_index.nl.md index a976464..ee53ef8 100644 --- a/content/docs/virtualization/_index.nl.md +++ b/content/docs/virtualization/_index.nl.md @@ -1,6 +1,6 @@ --- title: "Virtualisatie" -weight: 40 +weight: 6 toc: false --- diff --git a/content/docs/virtualization/looking-glass-attempt.md b/content/docs/virtualization/looking-glass-attempt.md index 008f3b9..f8e9b5b 100644 --- a/content/docs/virtualization/looking-glass-attempt.md +++ b/content/docs/virtualization/looking-glass-attempt.md @@ -1,13 +1,14 @@ --- -title: "Looking Glass B7 — GPU Passthrough Attempt" -weight: 21 +title: "Looking Glass B7: GPU Passthrough Attempt" +weight: 2 +next: docs/known-issues --- -I wanted to try GPU passthrough with Looking Glass — running Windows in a VM but with the real NVIDIA GPU assigned to it, getting near-native performance. Spent a good few hours on it. It doesn't work on this laptop, and the reason is a hardware limitation that Looking Glass can't work around. I'm documenting the full attempt here so others can save themselves the time. +I wanted to try GPU passthrough with Looking Glass: running Windows in a VM but with the real NVIDIA GPU assigned to it, getting near-native performance. Spent a good few hours on it. It doesn't work on this laptop, and the reason is a hardware limitation that Looking Glass can't work around. I'm documenting the full attempt here so others can save themselves the time. > **Prerequisite:** This assumes you already have a working Windows 11 VM set up with virt-manager. If not, follow the [VM Setup Guide]({{< relref "/docs/virtualization/vm-setup" >}}) first. -> **TL;DR:** Looking Glass does **not** work on the ASUS ROG Zephyrus G16 GA605WV. The RTX 4060 has no physical display outputs — all ports (HDMI, USB-C) are routed through the AMD iGPU. Windows can't find a "valid output device" for frame capture, so the host application fails immediately. This document describes everything that was tried and why it failed. +> **TL;DR:** Looking Glass does **not** work on the ASUS ROG Zephyrus G16 GA605WV. The RTX 4060 has no physical display outputs; all ports (HDMI, USB-C) are routed through the AMD iGPU. Windows can't find a "valid output device" for frame capture, so the host application fails immediately. This document describes everything that was tried and why it failed. ## What is Looking Glass? @@ -15,13 +16,13 @@ I wanted to try GPU passthrough with Looking Glass — running Windows in a VM b [Looking Glass](https://looking-glass.io) is an open-source project that allows you to use a GPU-passthrough Windows VM **without a physical monitor** attached to the dGPU. The Windows VM gets the real GPU assigned and the rendered image is streamed to the Linux host via shared memory (IVSHMEM). The result is near-native GPU performance in a VM, visible in a window on your Linux desktop. **Requirements for operation:** -- dGPU with direct display output (DisplayPort, HDMI) — or a virtual display dongle +- dGPU with direct display output (DisplayPort, HDMI), or a virtual display dongle - IOMMU isolation of the dGPU from the rest of the system - KVMFR kernel module on the host - Looking Glass host application in the Windows VM -## Phase 1 — Setting up IOMMU and VFIO +## Phase 1: Setting up IOMMU and VFIO ### Checking IOMMU groups @@ -98,7 +99,7 @@ nvidia-smi ``` -## Phase 2 — Installing KVMFR kernel module +## Phase 2: Installing KVMFR kernel module The KVMFR module provides the `/dev/kvmfr0` interface for the IVSHMEM shared memory buffer. @@ -151,7 +152,7 @@ sudo chmod 660 /dev/kvmfr0 ``` -## Phase 3 — Building the Looking Glass client +## Phase 3: Building the Looking Glass client ### Downloading the source @@ -208,11 +209,11 @@ looking-glass-client --version ``` -## Phase 4 — Modifying the VM XML +## Phase 4: Modifying the VM XML Changes via `sudo virsh edit win11`: -**SPICE — Disable GL (input/clipboard only):** +**SPICE: Disable GL (input/clipboard only):** ```xml @@ -222,7 +223,7 @@ Changes via `sudo virsh edit win11`: ``` -**Video — Looking Glass replaces the display:** +**Video: Looking Glass replaces the display:** ```xml