CachyOS Toolkit

Installieren

Der Installer legt das Toolkit nach ~/.local/share/cachyos-toolkit und einen Starter cachyos-toolkit nach ~/.local/bin. Prüfsumme wird verglichen, nichts läuft mit root.

curl -fsSL https://ts.lutti-multigaming.de/guides/cachyos-toolkit/install.sh | bash cachyos-toolkit

Lieber erst lesen? Archiv laden, entpacken, starten:

curl -fLO https://ts.lutti-multigaming.de/guides/cachyos-toolkit/cachyos-toolkit.tar.gz tar -xzf cachyos-toolkit.tar.gz && cd cachyos-toolkit ./cachyos-toolkit.sh

Voraussetzung

CachyOS (Arch geht mit Abstrichen – die cachyos-*-Pakete fehlen dann). Als normaler Benutzer starten; sudo wird einmal abgefragt und im Hintergrund wach gehalten.

Bedienung

Hauptmenü → Modul → Aktionen. Mehrere Aktionen auf einmal: 1 3 5. Alle Aktionen eines Moduls: a. Jede Aktion sagt vorher, was sie tut, und fragt bei Eingriffen nach.

So sieht das Hauptmenü aus 1) System-Basis Update, Basiswerkzeuge, fstrim, SMART, AUR-Helper 2) NVIDIA & Kernel Treiber, Module je Kernel, alte Kernel entfernen, /boot 3) Gaming-Stack Steam, Wine-CachyOS, MangoHud/goverlay, xpadneo, UFW-Ports 4) Performance sysctl-Profil, CPU-Profil, ZRAM, sched_ext, Kernel-Manager 5) Sicherheit ClamAV, rkhunter, chkrootkit, UFW, Komplett-Scan 6) KDE Energie Plasma-6-Energieprofile: Backup, Gaming-Profil, Reset 7) Werkzeuge Docker, CoolerControl, LACT, QEMU/KVM 8) Wartung paccache, Waisen, Journal, Shader-Caches, Reboot q) Schnellstart l) Log b) Backups 0) Beenden

~/.local/state/cachyos-toolkit.logJede Aktion, jeder Befehl mit Zeitstempel.

~/.local/state/cachyos-toolkit-backups/Kopie jeder Datei, bevor das Toolkit sie verändert – auch root-Dateien wie /etc/sysctl.d/….

Schnellstart für ein frisches System

Taste q im Menü oder cachyos-toolkit --quick. Reihenfolge ist Absicht: erst Update und Werkzeuge, dann Gaming-Stack, dann Tuning, zuletzt Schutz.

#	Aktion	Was passiert
1	Systemupdate	`pacman -Syu`
2	Basiswerkzeuge	pacman-contrib, smartmontools, htop/btop, powertop, lsof, dialog
3	AUR-Helper	paru (oder yay), falls keiner da ist
4	fstrim + smartd	wöchentlicher TRIM, SMART-Überwachung
5	Gaming-Basis	`cachyos-gaming-meta`, Vulkan 32/64 Bit, MangoHud, goverlay, protonup-qt, umu-launcher
6	sysctl-Gaming-Profil	`vm.max_map_count`, BBR + fq, TCP Fast Open – als `98-…conf`, damit CachyOS-Defaults gewinnen, wo sie sollen
7	CPU-Profil	power-profiles-daemon prüfen, Wahl zwischen dauerhaft performance oder balanced + `game-performance` pro Spiel
8	Sicherheit	ClamAV mit Paket-Units (`clamav-daemon`, `clamav-freshclam`), rkhunter (`--propupd`), chkrootkit
9	UFW	eingehend blockieren, ausgehend erlauben

Danach

Neustart. Steam-Startoption für Spiele: game-performance %command% – mit HUD: game-performance mangohud %command%.

Die Module im Detail

NVIDIA & Kernel

Erkennt die GPU und bietet den passenden Weg: vorgebaute Module linux-cachyos-*-nvidia-open für den laufenden CachyOS-Kernel (kein DKMS, schnellste Updates), nvidia-open-dkms für alle installierten Kernel, oder den Legacy-Zweig nvidia-580xx für Maxwell/Pascal/Volta (GTX 7xx–10xx). Prüft, ob jeder Kernel ein nvidia.ko hat, entfernt alte Kernel samt Headers und zeigt, wie voll /boot ist.

Der Klassiker

„Auf dem Gerät ist kein Speicherplatz mehr verfügbar“ beim Initramfs-Bau = /boot voll. Drei Kernel × 110 MB Initramfs reichen dafür. Aktion Kernel entfernen löst es.

Gaming-Stack

Basis über cachyos-gaming-meta (Steam, Wine-CachyOS, winetricks, gamemode …), dazu MangoHud/goverlay, protonup-qt und umu-launcher. Optional Lutris/Heroic, eine GPU-neutrale MangoHud.conf (Shift_R+F12 HUD, Shift_L+F1 FPS-Limit 0/60/142), eine dxvk.conf ohne nvapiHack, der Xbox-Controller-Treiber xpadneo-dkms mit den passenden Kernel-Headers, und UFW-Portfreigaben für Steam, Battle.net, Epic, Xbox und Star Citizen mit Launcher-Erkennung.

Performance

Zeigt zuerst den Ist-Zustand (Governor, EPP, sched_ext, THP, ZRAM, sysctl, mitigations). Setzt nur, was CachyOS nicht schon setzt. Aktiviert auf Wunsch scx_bpfland im Gaming-Modus über scx_loader und legt eine Kernel-Manager-Vorlage ab (native CPU-Optimierung, NVIDIA-open-Modul eingebaut, BBR3, 1000 Hz, Full LTO).

Sicherheit

ClamAV läuft über die Units aus dem Paket (clamav-freshclam, clamav-daemon) – keine selbstgebaute Service-Datei. Der Schnell-Scan nimmt das Home ohne Steam-Bibliothek, Wine-Prefixes, Lutris/Heroic/umu, Flatpak-Daten und Caches – bei einem Gaming-PC der Unterschied zwischen 15 Minuten und einer Nacht. Weitere Ordner per SCAN_EXTRA_EXCLUDES="Development:Videos". Scan läuft über clamdscan --multiscan --fdpass (Daemon), dann rkhunter und chkrootkit, alles in ein Log. Der Komplett-Scan bleibt als Option, warnt aber vorher mit der Home-Größe.

KDE Energie

Für Plasma 6 (powerdevilrc, kwriteconfig6). Gaming-Desktop-Profil: Bildschirm nach 30 min dunkel, nach 60 min aus, kein automatisches Standby, Energieprofil performance, Sperre nach 15 min. Backup vor jeder Änderung, Restore und Reset auf Plasma-Standard.

Werkzeuge & Wartung

Docker, CoolerControl oder fancontrol, LACT für Power-Limit und Lüfterkurve der GPU, QEMU/KVM mit OVMF und swtpm für eine Windows-11-VM. Wartung: paccache -rk2, verwaiste Pakete, Journal auf 14 Tage / 500 MB, Shader-Caches (Mesa, NVIDIA GLCache, DXVK, Steam), Snapper-Übersicht, Reboot-Assistent.

Direktaufruf & Optionen

# alle Aktionen mit Funktionsnamen cachyos-toolkit --list # Aktionen ohne Menü, nacheinander cachyos-toolkit sys_update game_base perf_sysctl_gaming # nur anzeigen, was passieren würde DRYRUN=1 cachyos-toolkit --quick # ohne Rückfragen (Automatisierung) ASSUME_YES=1 cachyos-toolkit maint_pacman_cache maint_journal

Das Port-Tool läuft auch allein: modules/tools/gaming-ports.sh --ports steam, --import epic, --full-auto.

Rückbau

Geänderte Dateien: Original liegt unter ~/.local/state/cachyos-toolkit-backups/, benannt nach Pfad und Zeitstempel. Zurückkopieren, fertig.
sysctl-Profil: sudo rm /etc/sysctl.d/98-cachyos-toolkit-gaming.conf && sudo sysctl --system
sched_ext: sudo systemctl disable --now scx_loader
KDE-Profil: Modul KDE Energie → Aus Backup wiederherstellen oder Reset.
Pakete: das Toolkit deinstalliert nichts still – Pakete bleiben, bis du sie entfernst.
Toolkit selbst: rm -rf ~/.local/share/cachyos-toolkit ~/.local/bin/cachyos-toolkit

Snapper

Bei einer Btrfs-Installation zieht CachyOS vor jedem pacman-Eingriff einen Snapshot. Der Weg zurück steht im GRUB-Menü unter CachyOS snapshots.

◆

Was es bewusst nicht tut

Die Vorgänger-Scripte stammten aus Chatbots und Foren und kopierten Arch-Tipps, die auf CachyOS falsch oder doppelt sind. Das ist rausgeflogen:

Weg damit	Warum
`cpupower`, Governor per sysfs	Auf CachyOS regelt `power-profiles-daemon` und überschreibt beides zur Laufzeit – GameMode konnte nicht mehr hochschalten. `game-performance` ist der richtige Weg.
`vm.swappiness = 10`	Swap ist hier ZRAM, also komprimierter RAM. CachyOS setzt 100–180 mit Absicht.
nouveau-Blacklist, I/O-Scheduler-Regeln, THP-Service, ZRAM-Config	Liefern `nvidia-utils` und `cachyos-settings` schon – doppelte Regeln machen nur Verwirrung.
`mitigations=off`	Sicherheits-Entscheidung, die niemand per Script für dich treffen sollte.
`grubby`, `kernel-manager --set-scheduler`	Gibt es auf Arch/CachyOS nicht.
Eigene `clamd.service`	Das Paket bringt `clamav-daemon.service` mit.
Xorg `Coolbits`	Unter Wayland wirkungslos. Takt und Power-Limit macht LACT.
`winetricks renderer=gdi`, LatencyFleX aus Quellen bauen	Ersteres bremst, letzteres scheitert ohne Build-Abhängigkeiten. LatencyFleX kommt aus dem AUR.

◆

Eigenes Modul

Eine Datei modules/NN-name.sh reicht – sie landet automatisch im Menü.

modules/90-meins.sh#!/usr/bin/env bash MODULE_TITLE="Meins" MODULE_DESC="Was das Modul tut" meins_hallo() { step "Hallo" pkg_install fastfetch # Repo oder AUR, nur wenn fehlt write_root_file /etc/meins.conf <<'X' key = value X ok "Fertig." } add_action meins_hallo "Beispielaktion"

Hilfsfunktionen: step / info / ok / warn / err / hint, pkg_install, sudo_run, write_root_file (mit Backup), backup_file, confirm, detect_gpu, installed_kernels. DRYRUN=1 wird von allen respektiert.

◆

Quelle & Download

cachyos-toolkit.tar.gzArchiv · SHA-256

install.shInstaller – lesbar, 25 Zeilen

cachyos-toolkit.shHauptscript zum Reinschauen

Passend dazu: CachyOS neu installieren – BIOS, Installer-Entscheidungen und die ersten zehn Minuten, bis das Toolkit übernimmt.