This repository provides a collection of configuration files and scripts to optimize CachyOS installations. These settings are designed to enhance system performance, responsiveness, and resource management for technical users.
Udev rules automatically apply system configurations upon device detection or state changes.
- Audio Power Management: Manages
snd-hda-intelpower saving to mitigate audio crackling, disabling it when AC-powered and re-enabling on battery. - ZRAM Swap Optimization: Configures ZRAM to prefer anonymous page compression (
vm.swappiness=150) and disables Zswap for efficient RAM-based swap. - Device Permissions: Sets
rtc0andhpetdevice group to "audio" for proper application access. - SATA Performance: Configures SATA host link power management to
max_performance. - I/O Scheduler Assignment: Dynamically assigns optimal I/O schedulers:
bfqfor HDDs,mq-deadlinefor SATA SSDs, andnonefor NVMe SSDs. - HDD Performance Tuning: Applies
hdparmsettings (-B 254 -S 0) to rotational disks. - NVIDIA Runtime Power Management: Enables/disables NVIDIA GPU runtime power management on driver bind/unbind events.
- CPU DMA Latency Access: Sets permissions for the
cpu_dma_latencydevice.
Sysctl parameters modify kernel behavior at runtime for system-wide performance and stability.
- Memory & I/O Management: Adjusts
vm.swappiness,vfs_cache_pressure,dirty_bytes,dirty_background_bytes, anddirty_writeback_centisecsfor balanced memory usage and efficient disk I/O. Disablesvm.page-cluster. - System Stability & Security: Disables
kernel.nmi_watchdog, enableskernel.unprivileged_userns_clone, restrictskernel.kptr_restrict, and disableskernel.kexec_load_disabled. - Logging & Network: Configures
kernel.printkto hide messages from console, increasesnet.core.netdev_max_backlog, and setsfs.file-max. - BORE Scheduler Options: Provides commented-out settings for granular control over the BORE scheduler if enabled.
Modprobe configurations control module loading and behavior for hardware-specific optimizations.
- Audio Power Saving: Explicitly disables
snd-hda-intelmodule power saving. - AMD GPU Driver Enforcement: Forces
amdgpudriver for GCN 1.0+ and 2.x GPUs, blacklistingradeon. - Watchdog Module Blacklist: Prevents loading of Intel TCO and AMD SP5100 watchdog timers.
- NVIDIA Driver Optimizations: Applies parameters like
NVreg_UsePageAttributeTable=1(PAT for CPU performance),NVreg_InitializeSystemMemoryAllocations=0(disables memory clearing for GPU),NVreg_DynamicPowerManagement=0x02(mobile GPU power saving), andNVreg_RegistryDwords=RMIntrLockingMode=1(frame-pacing).
Systemd unit and configuration files for streamlined boot, resource management, and service control.
- Journal Log Limits: Sets
journaldsize limit to 50MB. - Service Timeouts: Defines
DefaultTimeoutStartSec(15s) andDefaultTimeoutStopSec(10s) for services. - File Descriptor Limits: Increases
DefaultLimitNOFILEfor both system (2048:2097152) and user (1024:1048576) services. - Time Synchronization: Configures
systemd-timesyncdwith Cloudflare and Google NTP servers. - ZRAM Generator: Configures ZRAM with
zstdorlz4compression,ramsize, andswap-priority=100. - PCI Latency Service: Enables a systemd service to apply
pci-latencyscript at boot. - User Service Resource Delegation: Delegates CPU, cpuset, IO, memory, and pids to user services.
Configurations for temporary file cleanup and Transparent Huge Page (THP) behavior.
- Coredump Retention: Clears coredumps older than 3 days.
- THP Defragmentation: Sets
transparent_hugepage/defragtodefer+madvisefor tcmalloc-using applications. - THP Shrinker: Configures
khugepaged/max_ptes_nonefor Kernel 6.12+ to optimize THP memory usage.
- Touchpad Tapping: Enables tapping for libinput touchpads in X11.
- GDM Login Logo: Sets the CachyOS SVG as the GNOME login screen logo.
Bash and Lua scripts for system diagnostics, optimization, and administration.
cachyos-bugreport.sh: Generates a comprehensive system bug report including hardware, logs, and installed packages, with an option to upload. (Requires root)dlss-swapper: Forces latest NVIDIA DLSS presets (SR, RR, FG) and updates DLLs via NGX.dlss-swapper-dll: Forces latest NVIDIA DLSS presets (SR, RR, FG) but skips NGX updater.game-performance: Sets CPU power profile to "performance" viapowerprofilesctlwhen launching applications, with optional screensaver inhibition.kerver: Displays kernel version, x86_64 support, CPU config, and disk scheduler information.paste-cachyos: Uploads file content or stdin tohttps://paste.cachyos.org.pci-latency: Adjusts PCI latency timers for audio and other devices (sets sound cards to 80 cycles). (Requires root)sbctl-batch-sign: Helps batch sign files for Secure Boot, excluding common Microsoft/Windows EFI, .mui, .dll, and grub files. (Requires root, incompatible with Limine)topmem: A Lua script to display top processes by memory consumption (RSS, Swap, KSM profit), with sorting options.zink-run: Wrapper to run OpenGL applications using the Zink Gallium driver.