nixos-vorlagen/README.md

NixOS Gaming Base

Diese Basis-Config ist als wiederverwendbare Vorlage für ein NixOS-Gaming-Desktop-System gedacht und nutzt nixos-unstable, Chaotic-Nyx und getrennte Desktop-/Treiber-Configs. Fokus:

• aktueller Kernel
• umschaltbare Grafik-Configs für AMD oder Nvidia
• Chaotic mesa-git und 32-Bit-Libs für Steam/Proton
• PipeWire + Gaming-/Desktop-Audio-Tools
• Steam, Gamescope, MangoHud, Lutris, Heroic, LACT
• Basis für RGB- und Gaming-Peripherie
• Desktop-Auswahl zwischen KDE, GNOME, Budgie, Hyprland und COSMIC

Dokumentation

• SETUP_FUER_FREUNDE.md: Einstieg und kompletter Setup-Prozess
• CACHIX_ANLEITUNG.md: Cachix und schnellere Builds
• GAMING_CUSTOMIZATION_GUIDE.md: Gaming, Steam, Proton und Desktop-Anpassung
• MESA_GIT_ANLEITUNG.md: Mesa-Git und GPU-Treiber
• COSMIC_SETUP_ANLEITUNG.md: COSMIC Desktop
• KERNEL_GAMING_TWEAKS.md: Kernel-Auswahl und Performance
• PODMAN_DISTROBOX.md: Podman und Distrobox
• UPDATER_ANLEITUNG.md: nixos-update

Struktur

• flake.nix: Einstieg über nixos-unstable + chaotic-cx/nyx
• configuration.nix: Host-spezifische Einstiegsdatei
• modules/base.nix: Boot, Locale, Nix, Firmware, Governor, Basis-Tweaks
• modules/packages.nix: zentraler Ort für eigene Zusatzpakete
• modules/chaotic-nyx.nix: Chaotic-Nyx Aktivierung, allowUnfree, mesa-git
• modules/graphics/mesa-amd.nix: AMDGPU + Mesa/RADV Basis
• modules/graphics/mesa-amd-opencl.nix: AMD mit AMDVLK + OpenCL/ROCm
• modules/graphics/nvidia.nix: Nvidia-Treiber Basis mit proprietären Modulen
• modules/graphics/nvidia-open.nix: Nvidia mit offenen Kernel-Modulen
• modules/audio/pipewire.nix: PipeWire, JACK, Pulse, Audio-Tools
• modules/gaming.nix: Steam, Gamescope, Launcher-Stack
• modules/gaming/wine-proton.nix: Wine-, Proton- und Compatibility-Tools
• modules/containers/podman-distrobox.nix: Podman Container Runtime + Distrobox
• modules/kernel/linux-default.nix: Standard Linux Kernel (stabil)
• modules/kernel/linux-zen.nix: Linux Zen (Gaming-optimiert)
• modules/kernel/linux-hardened.nix: Linux Hardened (Sicherheit)
• modules/gaming-tweaks.nix: optionale Extra-Parameter für Gaming-Performance
• modules/kernel/linux-cachyos.nix: aktiver Gaming-Kernel in configuration.nix
• modules/desktop/common.nix: gemeinsame Desktop-Pakete
• modules/desktop/kde.nix: KDE Plasma 6 + SDDM
• modules/desktop/gnome.nix: GNOME + GDM
• modules/desktop/budgie.nix: Budgie
• modules/desktop/hyprland.nix: Hyprland + SDDM
• modules/desktop/cosmic.nix: schlanke COSMIC-Basis
• modules/desktop/cosmic-max.nix: COSMIC DE + Cosmic-Greeter (Wayland-native)
• modules/peripherals.nix: RGB-, Maus- und USB-Helfer

Quick Start - So nutzt ihr dieses Repo

Ihr möchtet diese Config für euer NixOS-Gaming-System nutzen? Hier geht's los:

1. Repo klonen

git clone <DIESES-REPO> ~/nixos-config
cd ~/nixos-config

2. Hardware-Konfiguration hinzufügen

Nach einer frischen NixOS-Installation:

sudo cp /etc/nixos/hardware-configuration.nix ./hardware-configuration.nix

3. Basis-Einstellungen anpassen (configuration.nix)

Öffnet configuration.nix und ändert diese Werte:

hostName = "euer-computer-name";  # z.B. "gaming-rig"
userName = "euer-nutzername";      # z.B. "max"
fullName = "Euer Name";            # z.B. "Max Mustermann"

4. Desktop und GPU wählen

Ändert diese Zeilen nach eurer Hardware:

desktopConfig = ./modules/desktop/kde.nix;        # oder: cosmic-max.nix, gnome.nix, hyprland.nix
graphicsConfig = ./modules/graphics/mesa-amd.nix; # oder: nvidia.nix, nvidia-open.nix, mesa-amd-opencl.nix
kernelConfig = ./modules/kernel/linux-cachyos.nix; # oder: linux-zen.nix, linux-xanmod.nix, linux-default.nix
enableExtraGamingTweaks = true;                    # false für konservativere Defaults

Nicht sicher? Empfehlungen:

• AMD-GPU: mesa-amd.nix + kde.nix
• NVIDIA-GPU: nvidia.nix + kde.nix
• Modern/Wayland: cosmic-max.nix (Achtung: weniger Gaming-optimiert als KDE)
• Kernel: linux-cachyos.nix für Gaming, linux-zen.nix als konservative Alternative

5. System bauen

sudo nixos-rebuild switch --flake .#template
sudo reboot

Das war's! Nach dem Neustart startet euer neues System.

Weitere Infos

• Gaming-Setup & Customization: Siehe docs/GAMING_CUSTOMIZATION_GUIDE.md
• Zu COSMIC wechseln: Siehe docs/COSMIC_SETUP_ANLEITUNG.md
• Mehr Pakete installieren: Edit modules/packages.nix
• Update-Befehl nutzen: nixos-update, nixos-update boot oder nixos-update update-inputs

Vorlage anpassen

Die wichtigsten Platzhalter stehen direkt in configuration.nix:

hostName = "example-host";
userName = "gamer";
fullName = "Gaming User";

Passe diese Werte vor dem ersten Build an. In modules/base.nix sind Europe/Berlin, de_DE.UTF-8 und de als Defaults gesetzt und können überschrieben werden. Zusätzliche allgemeine Pakete kannst du in modules/packages.nix eintragen.

Desktop und GPU auswählen

Die Auswahl passiert direkt oben in configuration.nix. Du änderst diese Zeilen:

desktopConfig = ./modules/desktop/kde.nix;
graphicsConfig = ./modules/graphics/mesa-amd.nix;
kernelConfig = ./modules/kernel/linux-cachyos.nix;
enableExtraGamingTweaks = true;

Für den Desktop sind diese Werte möglich:

• ./modules/desktop/kde.nix
• ./modules/desktop/gnome.nix
• ./modules/desktop/budgie.nix
• ./modules/desktop/hyprland.nix
• ./modules/desktop/cosmic.nix
• ./modules/desktop/cosmic-max.nix

Für die GPU bzw. den Treiber sind diese Werte möglich:

• ./modules/graphics/mesa-amd.nix
• ./modules/graphics/mesa-amd-opencl.nix
• ./modules/graphics/nvidia.nix
• ./modules/graphics/nvidia-open.nix

Beispiele:

KDE + AMD

desktopConfig = ./modules/desktop/kde.nix;
graphicsConfig = ./modules/graphics/mesa-amd.nix;

KDE + AMD mit OpenCL/AMDVLK

desktopConfig = ./modules/desktop/kde.nix;
graphicsConfig = ./modules/graphics/mesa-amd-opencl.nix;

GNOME + Nvidia

desktopConfig = ./modules/desktop/gnome.nix;
graphicsConfig = ./modules/graphics/nvidia.nix;

Hyprland + Nvidia

desktopConfig = ./modules/desktop/hyprland.nix;
graphicsConfig = ./modules/graphics/nvidia.nix;

KDE + Nvidia Open Kernel Module

desktopConfig = ./modules/desktop/kde.nix;
graphicsConfig = ./modules/graphics/nvidia-open.nix;

COSMIC (Modern Wayland-Native) + AMD

desktopConfig = ./modules/desktop/cosmic.nix;
graphicsConfig = ./modules/graphics/mesa-amd.nix;

COSMIC Max + AMD

desktopConfig = ./modules/desktop/cosmic-max.nix;
graphicsConfig = ./modules/graphics/mesa-amd.nix;

COSMIC Max + Nvidia

desktopConfig = ./modules/desktop/cosmic-max.nix;
graphicsConfig = ./modules/graphics/nvidia.nix;

Es wird dabei immer genau ein Desktop-Modul und genau ein Grafik-Modul importiert, nicht alle auf einmal. In modules/graphics/nvidia.nix sind modesetting, nvidiaSettings und nvidiaPackages.latest bereits gesetzt.

Kernel auswählen

Der aktive Kernel wird in configuration.nix über kernelConfig gewählt. Standard in diesem Repo ist CachyOS:

kernelConfig = ./modules/kernel/linux-cachyos.nix;

Empfehlungen:

• linux-cachyos.nix: beste Standardwahl für diesen Gaming-Desktop
• linux-zen.nix: konservative Gaming-Alternative, wenn CachyOS Probleme macht
• linux-default.nix: stabiler Fallback
• linux-hardened.nix: Security-Fokus, nicht ideal für Gaming
• linux-xanmod.nix: experimenteller Performance-Kernel

Weitere Details stehen in docs/KERNEL_GAMING_TWEAKS.md.

Empfehlung für AMD

• mesa-amd.nix ist die einfachste und sinnvollste Standardwahl für die meisten Gaming-Systeme mit AMD.
• mesa-amd-opencl.nix ist interessant, wenn du zusätzlich OpenCL/ROCm brauchst oder explizit AMDVLK testen willst.
• Wenn du nur spielen willst und keinen speziellen Compute- oder Vulkan-Workaround brauchst, nimm zuerst mesa-amd.nix.

Empfehlung für Nvidia

• nvidia.nix ist die Standardwahl für die meisten Systeme, wenn du maximale Kompatibilität mit aktuellen Spielen willst.
• nvidia-open.nix ist für Systeme gedacht, auf denen du die offenen Nvidia-Kernel-Module nutzen möchtest.
• Wenn du nicht gezielt testen willst, nimm zuerst nvidia.nix.

Empfehlung für COSMIC

• cosmic.nix ist die schlanke COSMIC-Variante mit den wichtigsten Desktop-Helfern.
• cosmic-max.nix ist die vollere COSMIC-Variante mit zusätzlichen COSMIC-Tools und Applets.
• Geeignet für Linux-Puristen und AMD-Benutzer; mit XWayland-Fallback auch für NVIDIA möglich.
• Wenn du einfach nur COSMIC nutzen willst, starte mit cosmic.nix.
• Wenn du gezielt die COSMIC-Extras willst, nimm cosmic-max.nix.
• Gaming: 7/10 – Solide für Linux-Native und Proton-Spiele, aber weniger spezialisiert als KDE.
• Tipp: Für maximale Gaming-Kompatibilität und Tweakbarkeit nimm KDE Plasma statt COSMIC.

Wine und Proton

Die Wine-/Proton-Helfer liegen jetzt in modules/gaming/wine-proton.nix und werden automatisch über modules/gaming.nix importiert.

Enthalten sind aktuell:

• wineWow64Packages.stable
• winetricks
• protontricks
• protonplus
• umu-launcher
• dxvk
• vkd3d-proton
• steam-run

Damit hast du direkt die typischen Werkzeuge für:

• Steam Proton mit protontricks
• zusätzliche Compatibility Tools über protonplus
• Wine-/Non-Steam-Starts über umu-launcher
• manuelles Debugging und Prefix-Arbeit mit winetricks

Chaotic-Nyx & Mesa-Git

Die Flake bindet github:chaotic-cx/nyx/nyxpkgs-unstable direkt ein und importiert chaotic.nixosModules.default.

Mesa-Git aktivieren/deaktivieren: Siehe modules/chaotic-nyx.nix und die Datei docs/MESA_GIT_ANLEITUNG.md.

Was ist Mesa-Git?

• Neueste tägliche GPU-Treiber-Builds von der Mesa-Entwicklung
• Ideal für moderne AMD-GPUs mit aktuellen Spielen
• Fallback-Option falls Probleme auftreten
• Wichtig: NVIDIA-Nutzer brauchen Mesa-Git nicht (benutzen proprietäre Treiber)

Nach der Installation

1. Die vom Installer erzeugte hardware-configuration.nix nach ./hardware-configuration.nix kopieren.
2. hostName, userName und fullName in configuration.nix anpassen.
3. In configuration.nix desktopConfig und graphicsConfig auf die gewünschten Module setzen.
4. Optional Locale, Tastatur und Zeitzone anpassen.
5. Passwort für den Benutzer setzen:

passwd <dein-userName>

6. Optional die Flake-Inputs aktualisieren:

nix flake update

7. System aktivieren:

sudo nixos-rebuild switch --flake .#template

Späterer Ausbau

• Desktop-spezifische Pakete und Defaults weiter tunen, z. B. Autologin, Keyring-Policy, Flatpak
• OBS / Discord / OpenRGB-Profile / Fancontrol
• Btrfs-Subvolumes, Snapshots, Impermanence
• spezielle Kernel- oder Scheduler-Tweaks, falls du sie wirklich brauchst