CachyOS

CachyOS provides enhanced kernels that offer improved performance and other benefits.

• General Information about kernels
  • linux-cachyos
  • Features
• CachyOS repositories
  • How to add CachyOS repositories
  • Check CPU compatibility
  • Uninstalling CachyOS repositories
  • Install SCX schedulers - only for linux-cachyos-sched-ext
• Other GNU/Linux distributions
  • Gentoo
  • Fedora
  • NixOS
• Support

The Schedulers listed below are supported

We have provided all these CPU schedulers because each scheduler performs differently depending on usage. We recommend testing each one to determine which best suits your specific requirements.

• (BORE) Burst-Oriented Response Enhancer Scheduler by firelzrd linux-cachyos / linux-bore / linux-cachyos-bore
• (EEVDF) Earliest Eligible Virtual Deadline - linux-cachyos-eevdf
• (SCHED-EXT) BPF extensible scheduler class - linux-cachyos-sched-ext
• (BMQ) BitMap queue CPU Scheduler Scheduler by Alfred Chen - linux-cachyos-bmq

• (SCHED-EXT) BPF extensible scheduler class BORE Scheduler - linux-cachyos

The CachyOS repositories provide prebuilt kernels in three different march versions: x86-64, x86-64-v3,x86-64-v4 and znver4 . In addition, the repositories also offer LTO-enabled kernels. The default linux-cachyos kernel is compiled with Clang and ThinLTO. For this kernel there is a linux-cachyos-gcc variant available.

• Very customizable PKGBUILD with many features and improvements.
• GCC/CLANG Optimization with automatically found CPU architecture or also selectable CPU architecture.
• Choose between LLVM/LTO & Thin-LTO or GCC.
• Choose between 300Hz, 500Hz, 600 Hz ,750Hz and 1000Hz. Defaults to 1000Hz
• Kernel Control Flow Integrity (kCFI) selectable when using LLVM

• 3 Different scheduler are supported,SCHED-EXT,BORE,EEVDF and BMQ scheduler
• AMD P-State Preferred Core / amd-pstate enhancements and fixes from -next.
• AMD 3D V-Cache optimizer driver
• AMD Hardware Feedback Interface
• Intel Pstate Hybrid CPU Driver
• SCHED-EXT Schedulers prebuilt in the repository # https://lwn.net/Articles/922405/ - linux-cachyos and linux-cachyos-sched-ext
• Cachy Sauce CONFIG_CACHY, enables various tweaks for the scheduler and other settings
• Scheduler patches from linux-next in linux-cachyos-bore and linux-cachyos-eevdf

• ZFS Filesystem support and prebuilt in the repository
• NVIDIA Module support including patches - Build the nvidia module together with the kernel
• Latest & improved ZSTD 1.5.6 patch-set
• UserKSM daemon from pf
• THP Shrinker - reduces memory usage for transparent hugepages
• Memory Management Tweaks (LRU, Compaction, Watermark)

• BBRv3 tcp_congestion_control

• Cherrypicked ClearLinux patches
• Back-ported patches from linux-next
• Scheduler patches from linux-next/tip
• OpenRGB and ACS Override support
• AMD: Allow override of min_powercap with amdgpu_ignore_min_pcap
• Steam Deck Patches included - Audio, HW Quirks, HID
• Rog Ally patches included
• v4l2loopback modules as default included
• HDR support enabled
• Various GCC Optimization flags applied (-fivopts -fmodulo-sched)
• NTSync patched and integrated into the kernel (NTSYNC=y)
• T2 Macbook support as default included

The repositories contain both Arch Linux and CachyOS packages, which have been re-built with flags optimized for performance, stability, and security.

• znver4 - Dedicated Zen4 optimized repository used for Zen 4 and Zen 5 CPUs
• x86-64-v4 - all Arch Linux packages with enhanced compilation flags
• x86-64-v3 - all Arch Linux packages with enhanced compilation flags
• x86-64 - currently only kernel packages

We've made it easy for you! Simply run the following commands to use our helper script that does all the work for you. 😉

Run the following commands:

1. Get archive with script

wget https://mirror.cachyos.org/cachyos-repo.tar.xz

If you don't have wget, install it with sudo pacman -S wget

2. Extract and enter into the archive

tar xvf cachyos-repo.tar.xz && cd cachyos-repo

3. Run script with sudo

sudo ./cachyos-repo.sh

1. Script will auto-detect CPU architecture, if CPU has x86-64-v4 or x86-64-v3 support, script will automatically use the repositories which are optimized with this flag > and some other flags.
2. Script will backup your old pacman.conf.

For more information, check out our GitHub or join our Discord community.

1. Install the cachyos keyring

sudo pacman-key --recv-keys F3B607488DB35A47 --keyserver keyserver.ubuntu.com
sudo pacman-key --lsign-key F3B607488DB35A47

2. Install required packages

ATTENTION: Installing the CachyOS Pacman, will install a forked pacman with features added from CachyOS, like "INSTALLED_FROM" and an automatic architecture check. Pacman 6.1 added a feature validation feature, which could lead when using the Arch Linux pacman into warnings. We are working with Arch Linux to provide a proper compatibility again. If you want to avoid this, don't add the "cachyos" repository, which contains the customized pacman. All other repositories like cachyos-v3, cachyos-v4, cachyos-extra/core-v3/4 are fine to add.

sudo pacman -U 'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-keyring-20240331-1-any.pkg.tar.zst' \
    'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-mirrorlist-18-1-any.pkg.tar.zst' \
    'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-v3-mirrorlist-18-1-any.pkg.tar.zst' \
    'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-v4-mirrorlist-6-1-any.pkg.tar.zst' \
    'https://mirror.cachyos.org/repo/x86_64/cachyos/pacman-7.0.0.r3.gf3211df-3.1-x86_64.pkg.tar.zst'

If you want to go back to the Arch Linux repositories and had our version of pacman installed, you will need to run the following command after the rollback to avoid getting %INSTALLED_DB% warnings:

sudo find /var/lib/pacman/local/ -type f -name "desc" -exec sed -i '/^%INSTALLED_DB%$/, 2d' {} \;

If you want to add our repositories manually, you must check the compatibility of the CPU with cachyos repositories.

If you are using the script above to add cachyos repositories, you can skip the check.

/lib/ld-linux-x86-64.so.2 --help | grep supported

Pay attention to the following text with brackets. (supported, searched)

• If you see x86-64-v4 (supported, searched), that means the CPU is compatible and can use x86-64-v4 instruction set.
• If you see x86-64-v4, that means the CPU is incompatible and can't use x86-64-v4 instruction set.

> /lib/ld-linux-x86-64.so.2 --help | grep supported
  x86-64-v4 (supported, searched)
  x86-64-v3 (supported, searched)
  x86-64-v2 (supported, searched)

You need to edit pacman.conf and add repositories.

sudo nano /etc/pacman.conf

# cachyos repos
[cachyos]
Include = /etc/pacman.d/cachyos-mirrorlist

# cachyos repos
## Only add if your CPU does v3 architecture
[cachyos-v3]
Include = /etc/pacman.d/cachyos-v3-mirrorlist
[cachyos-core-v3]
Include = /etc/pacman.d/cachyos-v3-mirrorlist
[cachyos-extra-v3]
Include = /etc/pacman.d/cachyos-v3-mirrorlist
[cachyos]
Include = /etc/pacman.d/cachyos-mirrorlist

# cachyos repos
## Only add if your CPU does support x86-64-v4 architecture
[cachyos-v4]
Include = /etc/pacman.d/cachyos-v4-mirrorlist
[cachyos-core-v4]
Include = /etc/pacman.d/cachyos-v4-mirrorlist
[cachyos-extra-v4]
Include = /etc/pacman.d/cachyos-v4-mirrorlist
[cachyos]
Include = /etc/pacman.d/cachyos-mirrorlist

Finally, update your system with CachyOS packages:

sudo pacman -Syu

Enjoy improved system speed with CachyOS packages!

This is handled via debuginfod. Just add following file to /etc/debuginfod/cachyos.urls

https://debuginfod.cachyos.org

See Uninstalling Cachyos Repositories

See sched-ext Tutorial

• Complete patch for simple patching on the kernel
• It is planned to implement into our kernel builder from cachyos buildsystem, which works also on other distributions.

Its a community maintained ebuild from a user, which can be used for a dynamic building right here

Or simply run:

eselect repository add CachyOS-kernels git https://github.com/Szowisz/CachyOS-kernels
emaint sync -r CachyOS-kernels

Port of kernel linux-cachyos-bore, linux-cachyos-rt-bore, linux-cachyos-bore-lto and linux-cachyos-lts by bieszczaders

Visit the COPR page for installation instructions and the latest announcements.

Nyx does provide a precompiled CachyOS Kernel and a bunch of other interesting packages. This repository is maintained by chaotic-aur Just follow this README

Discord: https://discord.gg/cachyos-862292009423470592
Forum: https://discuss.cachyos.org
Telegram: https://t.me/ zCzPX4cAFjk1MTYy
Matrix: https://matrix.cachyos.org

PayPal: https://paypal.me/pttrr
Patreon: https://www.patreon.com/CachyOS
BTC: bc1qmwglfchlc335du6pcu6w64cexu7cck0mzhyw42
ETH: 0xc2dc77327F78A7B85Db3941Eb49e74F41E961649
LTC: LgGTwcEBcXqMgNT6XyyNWABMb7dZVtVg9w

firelzrd for the BORE Scheduler
Arch Linux for the great linux operating system
And all other Kernel Developers and Supporters