Initial template repo

2026-06-16 20:55:00 +02:00
commit 65a547ad1a
39 changed files with 3628 additions and 0 deletions
@@ -0,0 +1,171 @@
+# Kernel Auswahl & Gaming-Tweaks
+
+Dieses Repo nutzt eine sichtbare Kernel-Auswahl in `configuration.nix`. Der aktuell aktive Standard ist CachyOS:
+
+```nix
+kernelConfig = ./modules/kernel/linux-cachyos.nix;
+```
+
+Wenn du nichts änderst, nutzt dein System also den CachyOS-Kernel plus die Basis-Tweaks aus `modules/base.nix`.
+
+---
+
+## Empfehlung
+
+| Situation | Empfehlung |
+|-----------|------------|
+| Gaming-PC mit AMD oder NVIDIA | `linux-cachyos.nix` |
+| Möglichst stabiler Gaming-Desktop | `linux-zen.nix` |
+| Probleme mit Spezial-Kerneln | `linux-default.nix` |
+| Security wichtiger als FPS | `linux-hardened.nix` |
+| Experimentieren und Risiko okay | `linux-xanmod.nix` |
+
+Kurz gesagt: Starte mit CachyOS. Wenn es Probleme gibt, nimm Zen. Wenn es immer noch Probleme gibt, nimm Default.
+
+---
+
+## Kernel wechseln
+
+Ändere in `configuration.nix` genau diese Zeile:
+
+```nix
+kernelConfig = ./modules/kernel/linux-cachyos.nix;
+```
+
+Mögliche Werte:
+
+- `./modules/kernel/linux-default.nix`
+- `./modules/kernel/linux-zen.nix`
+- `./modules/kernel/linux-hardened.nix`
+- `./modules/kernel/linux-cachyos.nix`
+- `./modules/kernel/linux-xanmod.nix`
+
+Danach neu bauen:
+
+```bash
+sudo nixos-rebuild switch --flake .#template
+sudo reboot
+```
+
+Nach dem Neustart prüfen:
+
+```bash
+uname -r
+```
+
+---
+
+## Kernel-Vergleich
+
+### CachyOS
+
+Datei: `modules/kernel/linux-cachyos.nix`
+
+- Beste Standardwahl in diesem Repo
+- Gaming- und Desktop-orientiert
+- Nutzt das Chaotic-Nyx-Ökosystem
+- Gute Wahl für aktuelle AMD- und NVIDIA-Gaming-Systeme
+
+### Linux Zen
+
+Datei: `modules/kernel/linux-zen.nix`
+
+- Sehr gute Desktop-Responsiveness
+- Meist konservativer als CachyOS oder Xanmod
+- Gute Alternative, wenn CachyOS auf einem System nicht sauber läuft
+
+### Linux Default
+
+Datei: `modules/kernel/linux-default.nix`
+
+- Stabiler Standard-Kernel aus nixpkgs
+- Gute Fallback-Wahl bei Treiber- oder Build-Problemen
+- Weniger auf Gaming-Latenz optimiert
+
+### Linux Hardened
+
+Datei: `modules/kernel/linux-hardened.nix`
+
+- Mehr Security-Hardening
+- Kann Performance kosten
+- Für Gaming normalerweise nicht die beste Wahl
+
+### Linux Xanmod
+
+Datei: `modules/kernel/linux-xanmod.nix`
+
+- Aggressive Performance-Ausrichtung
+- Eher für Enthusiasten und Tests
+- Wenn Stabilität wichtiger ist, bleib bei CachyOS oder Zen
+
+---
+
+## Was ist in `base.nix`?
+
+`modules/base.nix` enthält die allgemeinen System- und Gaming-Basics, aber nicht mehr die Kernel-Auswahl selbst.
+
+Aktiv sind dort unter anderem:
+
+- `fs.inotify.max_user_watches` für Launcher, Shader-Caches und große Libraries
+- `vm.max_map_count` für moderne Spiele und Proton
+- größere Netzwerk-Buffer für Online-Spiele
+- erhöhte File Descriptors für Steam, Lutris und ähnliche Tools
+- CPU-Governor `performance` als Default
+- Firmware, Microcode, Polkit, rtkit und Nix-GC
+
+Die Kernel-Entscheidung bleibt dadurch an einer Stelle: `kernelConfig` in `configuration.nix`.
+
+---
+
+## Extra-Gaming-Tweaks
+
+Zusätzliche Tweaks werden in `configuration.nix` über einen Boolean geschaltet:
+
+```nix
+enableExtraGamingTweaks = true;
+```
+
+Das Modul ist aktuell aktiviert und setzt nur zusätzliche, eher experimentelle Parameter wie:
+
+```nix
+"idle=nomwait"
+```
+
+Wenn du möglichst konservativ bleiben willst, setze den Wert auf `false`. Die wichtigsten Gaming-Basics bleiben trotzdem über `modules/base.nix` aktiv.
+
+---
+
+## Vorsicht bei `mitigations=off`
+
+In `modules/gaming-tweaks.nix` ist `mitigations=off` bewusst nur als Kommentar dokumentiert.
+
+Das kann in manchen Workloads Performance bringen, deaktiviert aber Schutzmechanismen gegen CPU-Sicherheitslücken. Für einen normalen Online-Gaming-Desktop ist das nicht empfehlenswert.
+
+---
+
+## Troubleshooting
+
+Wenn der Kernel nicht baut:
+
+```nix
+kernelConfig = ./modules/kernel/linux-zen.nix;
+```
+
+Wenn das System danach immer noch Probleme macht:
+
+```nix
+kernelConfig = ./modules/kernel/linux-default.nix;
+```
+
+Wenn der Stromverbrauch zu hoch ist:
+
+```nix
+powerManagement.cpuFreqGovernor = lib.mkForce "schedutil";
+```
+
+Danach jeweils:
+
+```bash
+sudo nixos-rebuild switch --flake .#template
+sudo reboot
+```