CachyOS

https://wiki.cachyos.org
Admin
CachyOS is an operating system focused on performance improvements, providing graphical and...
Tokens:69,989
Snippets:1,051
Trust Score:9.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### i3wm Autostart Program Example

Source: https://wiki.cachyos.org/configuration/desktop_environments/i3

Use `exec` to start a program when logging into an i3 session. This example starts Chromium.

```i3config
exec chromium
```

--------------------------------

### Example Output: EXT4 Partition Selection

Source: https://wiki.cachyos.org/features/cachy_chroot

Sample output showing the partition selection interface for an EXT4-based installation.

```text
Info: Found 8 block devices
Info: Found partition: Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
Info: Found partition: Partition: /dev/sda2: FS: vfat UUID: CA0D-2D5A
Info: Found partition: Partition: /dev/sdb1: FS: ntfs UUID: A4763F77763F48F6
Info: Found partition: Partition: /dev/sdc1: FS: ntfs UUID: C4CA216BCA215B46
Info: Found partition: Partition: /dev/sdc2: FS: ntfs UUID: 060C28590C284651
Info: Found partition: Partition: /dev/sdc3: FS: ntfs UUID: 3A3CF8B13CF86971
Info: Found partition: Partition: /dev/sdd1: FS: exfat UUID: 4FDC-0AAB
Info: Found partition: Partition: /dev/sdd2: FS: vfat UUID: 3105-B091
? Select the block device for the root partition (use arrow keys):  ›
❯ Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
Partition: /dev/sda2: FS: vfat UUID: CA0D-2D5A
Partition: /dev/sdb1: FS: ntfs UUID: A4763F77763F48F6
Partition: /dev/sdc1: FS: ntfs UUID: C4CA216BCA215B46
Partition: /dev/sdc2: FS: ntfs UUID: 060C28590C284651
Partition: /dev/sdc3: FS: ntfs UUID: 3A3CF8B13CF86971
Partition: /dev/sdd1: FS: exfat UUID: 4FDC-0AAB
Partition: /dev/sdd2: FS: vfat UUID: 3105-B091
```

--------------------------------

### Example Output: BTRFS Partition Selection

Source: https://wiki.cachyos.org/features/cachy_chroot

Sample output showing the partition selection interface for a BTRFS-based CachyOS installation.

```text
Info: Found 3 block devices
Info: Found partition: Partition: /dev/nvme0n1p1: FS: vfat UUID: EDA6-ED98
Info: Found partition: Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
Info: Found partition: Partition: /dev/nvme0n1p4: FS: btrfs UUID: 66e84339-8c77-4131-afce-50ec2cf67a80
? Select the block device for the root partition (use arrow keys):  ›
Partition: /dev/nvme0n1p1: FS: vfat UUID: EDA6-ED98
❯ Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
```

--------------------------------

### Install and Enable thermald

Source: https://wiki.cachyos.org/configuration/general_system_tweaks

Commands to install the thermal management daemon and start the service immediately.

```bash
sudo pacman -S thermald
sudo systemctl enable --now thermald.service
```

--------------------------------

### Enable and Start scx_loader Service

Source: https://wiki.cachyos.org/configuration/sched-ext

Enable the scx_loader service to start on boot and start it immediately.

```bash
sudo systemctl enable --now scx_loader.service
```

--------------------------------

### scx.service Configuration Example

Source: https://wiki.cachyos.org/configuration/sched-ext

This is an example of the old scx.service configuration file structure.

```shell
# List of scx_schedulers: scx_bpfland scx_central scx_flash scx_lavd scx_layered scx_nest scx_qmap scx_rlfifo scx_rustland scx_rusty scx_simple scx_userland
SCX_SCHEDULER=scx_lavd


# Set custom flags for the scheduler
SCX_FLAGS='--performance'

```

--------------------------------

### Install QEMU, VMM, and SWTPM on CachyOS

Source: https://wiki.cachyos.org/virtualization/qemu_and_vmm_setup

Installs the necessary packages for QEMU and VMM. Ensure you have `swtpm` if installing Windows 11 without a physical TPM.

```bash
# This will install the needed packages (note the "Windows 11" note below):
sudo pacman -S qemu-full virt-manager swtpm
# Force libvirt to use iptables
echo 'firewall_backend = "iptables"' | sudo tee -a /etc/libvirt/network.conf
# This will add the user to the "libvirt" group so they can use it:
sudo usermod -aG libvirt $USER
# LXC backend (optional, for linux containers, enabling both backends does not conflict):
systemctl enable --now libvirtd.service
# QEMU backend (for VMs):
systemctl enable --now libvirtd.socket
# This will bring Internet up in a VM whenever one starts:
sudo virsh net-autostart default
# And to enable the entire VM network to have unfettered transit: (You should consider if you need more granular firewall rules based on your use case and security posture)
sudo ufw route allow from 192.168.122.0/24
```

--------------------------------

### Limine Boot Entry Example

Source: https://wiki.cachyos.org/configuration/boot_manager_configuration

Example configuration for a Limine boot entry in /boot/limine.conf, specifying timeout, default entry, kernel path, commandline, and initramfs.

```shell
timeout: 5
default_entry: 2 # Points directly to the 'linux-cachyos' entry below


/+CachyOS        # Entry 1: A directory (use /+ to expand by default)
//linux-cachyos  # Entry 2: The actual bootable entry
    protocol: linux
    kernel_path: boot():/vmlinuz-linux-cachyos
    cmdline: quiet splash root=UUID=... rw # Basic kernel parameters
    module_path: boot():/initramfs-linux-cachyos.img
```

--------------------------------

### Install Noctalia Hyprland package

Source: https://wiki.cachyos.org/configuration/desktop_environments/hyprland

Install the core configuration package for the Noctalia Hyprland setup.

```bash
sudo pacman -S cachyos-hypr-noctalia
```

--------------------------------

### Install new desktop environment and settings

Source: https://wiki.cachyos.org/configuration/desktop_environments/switch_desktop

Install the desired desktop environment or window manager along with its corresponding CachyOS settings package.

```bash
sudo pacman -Syu i3-wm cachyos-i3wm-settings
```

--------------------------------

### Install EasyEffects and Audio Plugins

Source: https://wiki.cachyos.org/configuration/general_system_tweaks

Install the EasyEffects application and a suite of LV2 plugins to enable advanced audio processing.

```bash
# Install EasyEffects
sudo pacman -S easyeffects
# Install additional plugins for more effects
sudo pacman -S lsp-plugins-lv2
sudo pacman -S zam-plugins
sudo pacman -S calf
sudo pacman -S mda.lv2
```

--------------------------------

### Pacman configuration example

Source: https://wiki.cachyos.org/configuration/post_install_setup

Example of a pacman.conf file structure including the offline configuration path.

```ini
# REPOSITORIES
#   - can be defined here or included from another file
#   - pacman will search repositories in the order defined here
#   - local/custom mirrors can be added here or in separate files
#   - repositories listed first will take precedence when packages
#     have identical names, regardless of version number
#   - URLs will have $repo replaced by the name of the current repo
#   - URLs will have $arch replaced by the name of the architecture
#
# Repository entries are of the format:
#       [repo-name]
#       Server = ServerName
#       Include = IncludePath
#
# The header [repo-name] is crucial - it must be present and
# uncommented to enable the repo.
#
# GENERAL OPTIONS
[options]
# other options like 'Color', 'CheckSpace', etc. can be here
Include = /etc/pacman.d/offline.conf
```

--------------------------------

### View kerver output example

Source: https://wiki.cachyos.org/features/cachyos_settings

Example output showing kernel version, CPU configuration, and disk scheduler status.

```text
kerver


Check kernel version:


Linux version 6.19.8-1-hC (linux-hC@hC) (clang version 22.1.1, LLD 22.1.1) #1 SMP PREEMPT_DYNAMIC Sun, 15 Mar 2026 16:27:53 +0000
Linux CatchyOS 6.19.8-1-hC #1 SMP PREEMPT_DYNAMIC Sun, 15 Mar 2026 16:27:53 +0000 x86_64 GNU/Linux




Check x86_64 support:


  x86-64-v3 (supported, searched)
  x86-64-v2 (supported, searched)




Check CPU config:


CONFIG_X86_NATIVE_CPU=y
# CONFIG_GENERIC_CPU is not set
# CONFIG_MZEN4 is not set




Current disk schedulers:


sda: none mq-deadline kyber [adios] bfq
sdb: none mq-deadline kyber [adios] bfq


Check available schedulers:


BORE CPU Scheduler modification 6.6.2 by Masahito Suzuki
rcu: RCU calculated value of scheduler-enlistment delay is 100 jiffies.
io scheduler mq-deadline registered
io scheduler kyber registered
Adaptive Deadline I/O Scheduler 3.2.0 by Masahito Suzuki
io scheduler adios registered
io scheduler bfq registered
sched_ext: BPF scheduler "bpfland_1.1.0_gc505008f_x86_64_unknown_linux_gnu" enabled with options scx_bpfland
```

--------------------------------

### Install Flatpak and Gearlever

Source: https://wiki.cachyos.org/configuration/post_install_setup

Commands to install Flatpak and the Gearlever application manager.

```bash
sudo pacman -S flatpak
```

```bash
flatpak install flathub it.mijorus.gearlever
```

--------------------------------

### Example Output for x86-64-v4 Support

Source: https://wiki.cachyos.org/features/optimized_repos

This is an example of the output from checking CPU support, indicating that x86-64-v4 is supported and searched by the system.

```bash
  x86-64-v2 (supported, searched)
  x86-64-v3 (supported, searched)
  x86-64-v4 (supported, searched)
```

--------------------------------

### Install global menu support

Source: https://wiki.cachyos.org/configuration/post_install_setup

Install necessary modules to enable global menu support for applications.

```bash
# To enable global menu support, run the command and restart the app.
sudo pacman -S appmenu-gtk-module libdbusmenu-glib
```

--------------------------------

### Install cachy-chroot

Source: https://wiki.cachyos.org/features/cachy_chroot

Command to ensure the latest version of the helper is installed.

```bash
pacman -Sy cachy-chroot
```

--------------------------------

### Complete Steam Launch Option

Source: https://wiki.cachyos.org/configuration/gaming

A full example combining environment variables, wrappers, and application arguments.

```text
__GL_SHADER_DISK_CACHE_SKIP_CLEANUP=1 prime-run game-performance %command% -dx11
```

--------------------------------

### Install protonup-qt via pacman

Source: https://wiki.cachyos.org/configuration/gaming

Use this command to install the protonup-qt utility for managing Proton versions.

```bash
sudo pacman -S protonup-qt
```

--------------------------------

### scx_loader Configuration Example

Source: https://wiki.cachyos.org/configuration/sched-ext

This is the equivalent configuration for the new scx_loader configuration file.

```toml
default_sched = "scx_lavd"
default_mode = "Auto"

[scheds.scx_lavd]
auto_mode = ["--performance"]

```

--------------------------------

### Example Output: BTRFS Subvolume Mounting

Source: https://wiki.cachyos.org/features/cachy_chroot

Sample output showing the BTRFS subvolume mounting process.

```text
✔ Select the block device for the root partition (use arrow keys):  · Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
Info: Selected BTRFS partition, mounting and listing subvolumes...
Info: Mounting partition /dev/nvme0n1p2 at /tmp/cachyos-chroot-temp-mount-b09a027e-a61d-424f-858f-2e02be61b342-hwAeIm with options: []
Info: Unmounting partition at /tmp/cachyos-chroot-temp-mount-b09a027e-a61d-424f-858f-2e02be61b342-hwAeIm
? Do you want to use CachyOS BTRFS preset to auto mount root subvolume? (y/n) › # Enter yes if on CachyOS
```

--------------------------------

### Install schbench

Source: https://wiki.cachyos.org/configuration/sched-ext

Installs the schbench utility from the CachyOS repositories using pacman.

```bash
sudo pacman -S schbench

```

--------------------------------

### Install grub-btrfs-support

Source: https://wiki.cachyos.org/configuration/btrfs_snapshots

Install the grub-btrfs-support package to enable automatic detection of BTRFS snapshots in the GRUB menu.

```bash
sudo pacman -Syu grub-btrfs-support
```

--------------------------------

### Enroll Limine Config and Sign Binary

Source: https://wiki.cachyos.org/configuration/secure_boot_setup

Execute these commands to finalize the Secure Boot setup for Limine.

```bash
# Use limine-enroll-config to enroll the config checksum and sign Limine's EFI binary
# This uses sbctl under the hood
sudo limine-enroll-config
sudo limine-update
```

--------------------------------

### Enable and Start systemd Mount

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

After creating the mount file, reload the systemd daemon and then enable and start the mount service. This ensures the drive is mounted at boot.

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now home-$USER-games.mount
```

--------------------------------

### Install umu-launcher

Source: https://wiki.cachyos.org/configuration/gaming

Command to install the umu-launcher package from the CachyOS repository.

```bash
sudo pacman -S cachyos/umu-launcher
```

--------------------------------

### Install and upgrade packages with Shelly

Source: https://wiki.cachyos.org/configuration/post_install_setup

Upgrades standard packages and installs a specific package.

```bash
shelly install --upgrade {pkg}
# Example:
shelly install --upgrade discord
```

--------------------------------

### Install Wi-Fi Firmware Package

Source: https://wiki.cachyos.org/installation/installation_t2macbook

Install the downloaded firmware package using pacman. This command requires root privileges.

```bash
sudo pacman -U apple-bcm-firmware-14.0-1-any.pkg.tar.zst
```

--------------------------------

### Install os-prober for GRUB

Source: https://wiki.cachyos.org/installation/installation_on_root

Install the `os-prober` package, which GRUB uses to detect other operating systems like Windows.

```bash
sudo pacman -S os-prober
```

--------------------------------

### Steam Wrapper Options

Source: https://wiki.cachyos.org/configuration/gaming

Examples of using wrappers like mangohud or gamescope in launch options.

```text
mangohud --dlsym
# Or
gamescope -W 1680 -H 1050 -w 1280 -h 720 -S fit -F fsr --mangoapp --
```

--------------------------------

### Install lua-luv for topmem

Source: https://wiki.cachyos.org/features/cachyos_settings

Required dependency installation for the topmem memory monitoring script.

```bash
# Install lua-luv to run the script:
sudo pacman -S lua-luv
```

--------------------------------

### Sched-ext Loader Configuration Example

Source: https://wiki.cachyos.org/features/kernel_manager

This TOML configuration file shows an example of how the scx_loader is set up for the scx_bpfland scheduler with the Gaming profile. It defines default scheduler and mode, and specific flags for different profiles.

```toml
default_sched = "scx_bpfland"
default_mode = "Gaming"

[scheds.scx_bpfland]
auto_mode = []
gaming_mode = ["-m", "performance"]
lowlatency_mode = ["-k", "-s", "5000", "-l", "5000"]
powersave_mode = ["-m", "powersave"]

```

--------------------------------

### Install sched-ext and tools (Stable)

Source: https://wiki.cachyos.org/configuration/sched-ext

Installs the stable branch of scx-scheds and scx-tools, including the scx_loader and scxctl utilities.

```bash
sudo pacman -S scx-scheds scx-tools
```

--------------------------------

### Install grub-btrfs-support for BTRFS Snapshots

Source: https://wiki.cachyos.org/configuration/boot_manager_configuration

Install the grub-btrfs-support package to automatically detect BTRFS snapshots and add them to the GRUB menu.

```shell
sudo pacman -S grub-btrfs-support
```

--------------------------------

### Install cachyos-benchmarker

Source: https://wiki.cachyos.org/configuration/sched-ext

Install the cachyos-benchmarker tool using pacman. This tool is essential for evaluating and comparing the performance of different CPU schedulers.

```bash
sudo pacman -S cachyos-benchmarker
```

--------------------------------

### schbench output example

Source: https://wiki.cachyos.org/configuration/sched-ext

Example output from a schbench run, showing percentiles for wakeup latencies, request latencies, and requests per second (RPS). This data helps in evaluating scheduler responsiveness and throughput.

```text
Wakeup Latencies percentiles (usec) runtime 10 (s) (2406 total samples)
  50.0th: 60         (648 samples)
  90.0th: 2034       (968 samples)
* 99.0th: 4104       (211 samples)
  99.9th: 10128      (22 samples)
  min=1, max=10308
Request Latencies percentiles (usec) runtime 10 (s) (2394 total samples)
  50.0th: 49216      (726 samples)
  90.0th: 69760      (954 samples)
* 99.0th: 166656     (212 samples)
  99.9th: 273920     (21 samples)
  min=11770, max=334247
RPS percentiles (requests) runtime 10 (s) (11 total samples)
  20.0th: 234        (3 samples)
* 50.0th: 238        (3 samples)
  90.0th: 241        (4 samples)
  min=230, max=248
current rps: 230.99
Wakeup Latencies percentiles (usec) runtime 10 (s) (2406 total samples)
  50.0th: 60         (648 samples)
  90.0th: 2034       (968 samples)
* 99.0th: 4104       (211 samples)
  99.9th: 10128      (22 samples)
  min=1, max=10308
Request Latencies percentiles (usec) runtime 10 (s) (2406 total samples)
  50.0th: 49216      (729 samples)
  90.0th: 69760      (956 samples)
* 99.0th: 165632     (212 samples)
  99.9th: 273920     (22 samples)
  min=11770, max=334247
RPS percentiles (requests) runtime 10 (s) (11 total samples)
  20.0th: 234        (3 samples)
* 50.0th: 238        (3 samples)
  90.0th: 241        (4 samples)
  min=230, max=248
average rps: 240.60

```

--------------------------------

### Enable Noctalia Greeter

Source: https://wiki.cachyos.org/configuration/desktop_environments/hyprland

Install and enable the Noctalia Greeter display manager.

```bash
sudo pacman -Syu noctalia-greeter
systemctl disable display-manager
systemctl enable greetd
```

--------------------------------

### Add lz4 Module

Source: https://wiki.cachyos.org/configuration/general_system_tweaks

Example of the updated MODULES array in mkinitcpio.conf.

```bash
MODULES=(... lz4)
```

--------------------------------

### Steam Application Arguments

Source: https://wiki.cachyos.org/configuration/gaming

Example of passing arguments to the application using the %command% placeholder.

```text
%command% -dx11
```

--------------------------------

### Install Patched OBS Studio

Source: https://wiki.cachyos.org/configuration/general_system_tweaks

Install the custom obs-studio-browser package which includes patches for CUDA and virtual camera issues.

```bash
sudo pacman -S obs-studio-browser
# If you previously had the obs-studio installed then pacman is going to ask you if
# you want to replace it, if so enter "Y".
```

--------------------------------

### Automated Installation of CachyOS Repositories

Source: https://wiki.cachyos.org/features/optimized_repos

Use this script to automate the installation of CachyOS repositories. It detects your CPU's instruction sets for optimized repository selection and backs up your pacman.conf.

```bash
curl https://mirror.cachyos.org/cachyos-repo.tar.xz -o cachyos-repo.tar.xz
tar xvf cachyos-repo.tar.xz && cd cachyos-repo
sudo ./cachyos-repo.sh
```

--------------------------------

### Start a Scheduler with Mode and Arguments

Source: https://wiki.cachyos.org/configuration/sched-ext

Uses scxctl to start a scheduler with a specific mode and custom arguments. Arguments are provided as key-value pairs.

```bash
scxctl start --sched flash --mode gaming
```

```bash
scxctl start --sched cosmos --args="-c,75,-m,0-15"
```

--------------------------------

### Example output of topmem

Source: https://wiki.cachyos.org/features/cachyos_settings

Sample output showing memory, swap, and KSM usage for top processes.

```text
topmem


MEMORY                Top 10 processes        SWAP      KSM
1333M     node                                0M        0M
811M      exe                                 0M        0M
759M      VQ6B1EUZqoCU04zoRU= --cha...        0M        0M
681M      node                                0M        0M
531M      zed-editor                          0M        0M
484M      brave                               0M        0M
424M      qs                                  0M        0M
408M      mdx-language-server                 0M        0M
395M      Telegram                            0M        0M
365M      VQ6B1EUZqoCU04zoRU= --cha...        0M        0M
```

--------------------------------

### Steam Environment Variables

Source: https://wiki.cachyos.org/configuration/gaming

Examples of setting environment variables for Steam launch options.

```text
PROTON_DXVK_D3D8=1
# Or
DXVK_HUD="fps,memory,version,api"
```

--------------------------------

### Install Emerald Theme and Qogir Icons for KDE

Source: https://wiki.cachyos.org/configuration/desktop_environments/kde

Install the CachyOS Emerald KDE theme and Qogir icon theme to replicate the look shown in KDE screenshots. Apply these in the 'Appearance & Style - Colors & Themes' settings.

```bash
sudo pacman -S cachyos-emerald-kde-theme-git qogir-icon-theme
```

--------------------------------

### Example Output: EXT4 Mounting and Chroot

Source: https://wiki.cachyos.org/features/cachy_chroot

Sample output showing the mounting of additional partitions and entering the chroot environment for an EXT4 system.

```text
✔ Select the block device for the root partition (use arrow keys):  · Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
Info: Mounting partition /dev/sda1 at /tmp/cachyos-chroot-root-mount-b7fef200-fbb8-4783-9fad-46c5e8b7ca0e-LtsXXC with options: []
Info: Mounting additional partitions based on /etc/fstab...
Info: Found 3 entries in /etc/fstab
Warning: Partition UUID=b7fef200-fbb8-4783-9fad-46c5e8b7ca0e already mounted, skipping...
Info: Mounting partition /dev/sda2 at /tmp/cachyos-chroot-root-mount-b7fef200-fbb8-4783-9fad-46c5e8b7ca0e-LtsXXC/boot with options: []
Info: Finished mounting additional partitions
✔ Do you want to mount additional partitions? · no
Info: Chrooting into the configured root partition...
Info: To exit the chroot, type 'exit' or press Ctrl+D
```

--------------------------------

### Identify Splash Image Path

Source: https://wiki.cachyos.org/configuration/secure_boot_setup

Example line found within the limine.conf file.

```text
wallpaper: boot():/limine-splash.png
```

--------------------------------

### Auto-detect and Install AMD GPU Drivers

Source: https://wiki.cachyos.org/features/chwd/gpu_migration

After installing an AMD GPU, use this command to automatically detect and install the correct AMD packages.

```bash
sudo chwd -a
```

--------------------------------

### Install Missing X11 Session for KDE Plasma

Source: https://wiki.cachyos.org/configuration/desktop_environments/kde

Use this command to install the X11 session if it's missing from your default KDE Plasma installation.

```bash
sudo pacman -S plasma-x11-session kwin-x11
```

--------------------------------

### Install pacman-offline

Source: https://wiki.cachyos.org/configuration/post_install_setup

Installs the package required for offline system updates.

```bash
sudo pacman -S pacman-offline
```

--------------------------------

### Check for Meld installation

Source: https://wiki.cachyos.org/configuration/desktop_environments/hyprland

Verify if the meld utility is installed on the system.

```bash
pacman -Q meld
```

--------------------------------

### systemd Mount File Example (tl;dr)

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

A simplified systemd mount file. Replace placeholders with your partition's UUID, desired mount point, filesystem type, and any necessary options.

```ini
[Unit]
Description=Mount drive


[Mount]
What=UUID=<partition UUID>
Where=/mnt/foo
Type=somefs
Options=defaults


[Install]
WantedBy=multi-user.target
```

--------------------------------

### Install sbctl

Source: https://wiki.cachyos.org/configuration/secure_boot_setup

Install the sbctl package using the pacman package manager.

```bash
sudo pacman -S sbctl
```

--------------------------------

### Transition from v4 to znver4 Repositories

Source: https://wiki.cachyos.org/features/optimized_repos

Commands to execute after adding znver4 repositories to transition from v4 packages. This includes cleaning the pacman cache, synchronizing databases, and replacing v4 packages with znver4 equivalents.

```bash
sudo pacman -Scc # Enter Y in both instances
sudo pacman -Sy
pacman -Qqn | sudo pacman -S --needed - # To replace all the v4 packages with the znver4 packages
# Reboot your system
```

--------------------------------

### Install gaming meta-package

Source: https://wiki.cachyos.org/configuration/gaming

Installs the cachyos-gaming-meta package containing essential gaming-related libraries.

```bash
sudo pacman -S cachyos-gaming-meta
```

--------------------------------

### Mount Drive and Enable on Boot (tl;dr)

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

Enable the systemd mount unit to ensure the drive is mounted automatically at boot, and start it immediately.

```bash
sudo systemctl enable --now mnt-foo.mount
```

--------------------------------

### Create and Configure scx_loader.toml

Source: https://wiki.cachyos.org/configuration/sched-ext

Create the scx_loader.toml file and add the necessary configuration lines. Edit the default_sched line to your desired scheduler.

```bash
# Micro editor is going to create a new file.
sudo micro /etc/scx_loader.toml
# Add the following lines:


default_sched = "scx_bpfland" # Edit this line to the scheduler you want scx_loader to start at boot
default_mode = "Auto" # Possible values: "Auto", "Gaming", "LowLatency", "PowerSave".


# Press CTRL + S to save changes and CTRL + Q to exit Micro.

```

--------------------------------

### Install missing NVIDIA drivers

Source: https://wiki.cachyos.org/cachyos_basic/faq

Install the NVIDIA package to resolve missing module errors.

```bash
sudo pacman -S nvidia
```

--------------------------------

### Install proton-cachyos-slr via pacman

Source: https://wiki.cachyos.org/configuration/gaming

Use this command to install the proton-cachyos-slr package directly from the terminal.

```bash
sudo pacman -S proton-cachyos-slr
```

--------------------------------

### Install FUSE for AppImage Support

Source: https://wiki.cachyos.org/configuration/post_install_setup

Install the FUSE library required to run AppImages on the system.

```bash
sudo pacman -S fuse2
```

--------------------------------

### Add Startup Applications in Niri

Source: https://wiki.cachyos.org/configuration/desktop_environments/niri

Use the 'spawn-at-startup' command within your configuration to automatically launch applications when Niri starts.

```toml
spawn-at-startup "your-application"
```

--------------------------------

### Copy limine-snapper-sync.conf

Source: https://wiki.cachyos.org/configuration/btrfs_snapshots

Creates a backup of the limine-snapper-sync configuration file before editing.

```bash
sudo cp /etc/limine-snapper-sync.conf /etc/limine-snapper-sync.conf.orig
```

--------------------------------

### Snapper Snapshot Output Example

Source: https://wiki.cachyos.org/configuration/btrfs_snapshots

Displays a typical output from the Snapper CLI listing existing snapshots with details like type, date, user, cleanup algorithm, and description.

```bash
# │ Type   │ Pre # │ Date                     │ User │ Cleanup │ Description                                                              │ Userdata
────┼────────┼───────┼──────────────────────────┼──────┼─────────┼──────────────────────────────────────────────────────────────────────────┼─────────
0   │ single │       │                          │ root │         │ current                                                                  │
715 │ pre    │       │ Thu 22 Jan 2026 16:14:07 │ root │ number  │ pacman -S -y -u --config /etc/pacman.conf --                             │
716 │ post   │   715 │ Thu 22 Jan 2026 16:14:25 │ root │ number  │ docker-buildx lilv sof-firmware zed                                      │
717 │ pre    │       │ Sat 24 Jan 2026 11:19:48 │ root │ number  │ pacman -S -y -u --config /etc/pacman.conf --                             │
718 │ post   │   717 │ Sat 24 Jan 2026 11:20:19 │ root │ number  │ bpf cachyos-hello cachyos-wallpapers cpupower jdk-openjdk ldb less libev │
719 │ pre    │       │ Sat 24 Jan 2026 11:20:31 │ root │ number  │ pacman -U --config /etc/pacman.conf -- /home/mario/.cache/yay/visual-s   │
720 │ post   │   719 │ Sat 24 Jan 2026 11:20:36 │ root │ number  │ visual-studio-code-bin                                                   │
721 │ pre    │       │ Sat 24 Jan 2026 20:46:40 │ root │ number  │ pacman -Syu plasma-login-manager                                         │
722 │ post   │   721 │ Sat 24 Jan 2026 20:46:48 │ root │ number  │ cmake fastfetch harfbuzz harfbuzz-icu jdk21-openjdk lib32-harfbuzz lib32 │
723 │ pre    │       │ Sat 24 Jan 2026 20:46:53 │ root │ number  │ pacman -R sddm-kcm cachyos-themes-sddm sddm                              │
724 │ post   │   723 │ Sat 24 Jan 2026 20:46:56 │ root │ number  │ cachyos-themes-sddm sddm sddm-kcm                                        │
725 │ pre    │       │ Sun 25 Jan 2026 08:05:05 │ root │ number  │ pacman -S -y -u --config /etc/pacman.conf --                             │
726 │ post   │   725 │ Sun 25 Jan 2026 08:05:11 │ root │ number  │ plasma-login-manager                                                     │
727 │ pre    │       │ Sun 25 Jan 2026 15:55:28 │ root │ number  │ pacman -S --config /etc/pacman.conf -- cachyos-extra-znver4/caligula     │
728 │ post   │   727 │ Sun 25 Jan 2026 15:55:30 │ root │ number  │ caligula                                                                 │
```

--------------------------------

### List Installed NVIDIA Driver Profiles

Source: https://wiki.cachyos.org/features/chwd/gpu_migration

Check which NVIDIA driver profile is currently installed on your system.

```bash
sudo chwd --list-installed
```

--------------------------------

### Backup current configuration files

Source: https://wiki.cachyos.org/configuration/desktop_environments/switch_desktop

Create a backup of existing .config and .local directories before applying new desktop environment settings.

```bash
mkdir -p ~/config-backup
cp -r ~/.config ~/config-backup/
cp -r ~/.local ~/config-backup/
```

--------------------------------

### Start Scheduler via D-Bus

Source: https://wiki.cachyos.org/configuration/sched-ext

Uses `dbus-send` to interact with `scx_loader` and start the 'scx_rusty' scheduler with default arguments.

```bash
dbus-send --system --print-reply --dest=org.scx.Loader /org/scx/Loader org.scx.Loader.StartScheduler string:scx_rusty uint32:0
```

--------------------------------

### Enable Secure Boot support in GRUB

Source: https://wiki.cachyos.org/configuration/secure_boot_setup

Run this command to install GRUB with Secure Boot support enabled.

```bash
sudo grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=cachyos --modules="tpm" --disable-shim-lock
```

--------------------------------

### Configure Wi-Fi in CachyOS Live Environment

Source: https://wiki.cachyos.org/installation/installation_t2macbook

Run these commands to copy Wi-Fi firmware from the EFI partition and configure NetworkManager to use the iwd backend for Wi-Fi connectivity during installation.

```bash
# Mount the EFI partition (usually nvme0n1p1 on T2 Macs)
sudo mkdir -p /tmp/apple-wifi-efi
sudo mount /dev/nvme0n1p1 /tmp/apple-wifi-efi


# Copy firmware from EFI to the live environment
bash /tmp/apple-wifi-efi/firmware.sh get_from_efi
sudo umount /tmp/apple-wifi-efi


# Configure NetworkManager to use iwd backend
cat <<EOF | sudo tee /etc/NetworkManager/conf.d/wifi_backend.conf
[device]
wifi.backend=iwd
EOF
sudo systemctl restart NetworkManager
```

--------------------------------

### Enter CachyOS Chroot

Source: https://wiki.cachyos.org/cachyos_basic/faq

Command to initiate the chroot environment from the Live ISO.

```bash
sudo cachy-chroot
```

--------------------------------

### Install Necessary CachyOS Packages

Source: https://wiki.cachyos.org/features/optimized_repos

Installs essential CachyOS packages, including keyring and mirrorlist files, and an updated pacman version.

```bash
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-27-1-any.pkg.tar.zst'
'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-v3-mirrorlist-27-1-any.pkg.tar.zst'
'https://mirror.cachyos.org/repo/x86_64/cachyos/cachyos-v4-mirrorlist-27-1-any.pkg.tar.zst'
'https://mirror.cachyos.org/repo/x86_64/cachyos/pacman-7.1.0.r9.g54d9411-4-x86_64.pkg.tar.zst'
```

--------------------------------

### Benchmark Run Summary Example

Source: https://wiki.cachyos.org/configuration/sched-ext

This is an example of the terminal output generated by the benchmark_scraper.py script, showing performance metrics for various tests.

```text
stress-ng cpu-cache-mem: 15.26
y-cruncher pi 1b: 31.23
perf sched msg fork thread: 8.892
perf memcpy: 13.53
namd 92K atoms: 53.54
calculating prime numbers: 11.126
argon2 hashing: 6.62
ffmpeg compilation: 53.38
compression: 61.13
kernel defconfig: 130.73
blender render: 96.29
x265 encoding: 24.99

Total time (s): 506.72
Total score: 70.71

Name: p2dq
Date: 2025-09-29-2115

System:    Kernel: 6.17.0-1.1-cachyos-p2dq arch: x86_64 bits: 64
           Desktop: KDE Plasma v: 6.4.5 Distro: CachyOS
Memory:    System RAM: total: 32 GiB available: 30.61 GiB used: 7.54 GiB (24.6%)
           Device-1: Channel-A DIMM 0 type: LPDDR5 size: 8 GiB speed: 7500 MT/s
           Device-2: Channel-B DIMM 0 type: LPDDR5 size: 8 GiB speed: 7500 MT/s
           Device-3: Channel-C DIMM 0 type: LPDDR5 size: 8 GiB speed: 7500 MT/s
           Device-4: Channel-D DIMM 0 type: LPDDR5 size: 8 GiB speed: 7500 MT/s
CPU:       Info: 8-core model: AMD Ryzen 7 8845HS w/ Radeon 780M Graphics bits: 64 type: MT MCP cache: L2: 8 MiB
           Speed (MHz): avg: 3366 min/max: 419/5138 cores: 1: 3366 2: 3366 3: 3366 4: 3366 5: 3366 6: 3366 7: 3366 8: 3366 9: 3366 10: 3366 11: 3366 12: 3366 13: 3366 14: 3366 15: 3366 16: 3366

SCX Scheduler: p2dq_1.0.21_gf90c2aa1_dirty_x86_64_unknown_linux_gnu

SCX Version: p2dq_1.0.21_gf90c2aa1_dirty_x86_64_unknown_linux_gnu

 Version         : 0.5.1-1

```

--------------------------------

### Install and enable switcheroo-control

Source: https://wiki.cachyos.org/configuration/dual_gpu

Required for desktop environment GPU switching features. Ensure the service is active to enable dedicated graphics options.

```bash
sudo pacman -S switcheroo-control
sudo systemctl enable --now switcheroo-control
```

--------------------------------

### List partition UUIDs and filesystem types

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

Use `lsblk -f` to display block devices, their filesystem types, labels, UUIDs, and mount points. This is often sufficient to identify the partition you need to mount.

```bash
lsblk -f
```

```text
NAME        FSTYPE FSVER LABEL UUID                                 FSAVAIL FSUSE% MOUNTPOINTS
zram0                                                                              [SWAP]
nvme0n1
├─nvme0n1p1 vfat   FAT32       E04D-9F05
├─nvme0n1p2
├─nvme0n1p3 ntfs               08A24E90A24E81E4                      715.4G    50% /
├─nvme0n1p4 vfat   FAT32       E09C-D4DA                             628.1M    39% /boot
├─nvme0n1p5 ext4   1.0         187a9f06-9411-48d9-b941-f03c2e605812  203.6G    47% /
└─nvme0n1p6 ntfs

```

--------------------------------

### Install gaming applications meta-package

Source: https://wiki.cachyos.org/configuration/gaming

Installs the cachyos-gaming-applications package containing popular tools like Gamescope, MangoHud, and various game launchers.

```bash
sudo pacman -S cachyos-gaming-applications
```

--------------------------------

### Open fstab for Editing

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

Use nano to edit the fstab file as root. This is the first step to adding a new drive entry.

```bash
sudo nano /etc/fstab
```

--------------------------------

### Start Scheduler with Arguments via D-Bus

Source: https://wiki.cachyos.org/configuration/sched-ext

Uses `dbus-send` to start the 'scx_bpfland' scheduler with specific arguments '-k' and '-c 0' via the `scx_loader` D-Bus interface.

```bash
# This example starts scx_bpfland with the following flags: -k -c 0
dbus-send --system --print-reply --dest=org.scx.Loader /org/scx/Loader org.scx.Loader.StartSchedulerWithArgs string:scx_bpfland array:string:"-k","-c","0"
```

--------------------------------

### Example fstab entry

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

Add this line to the end of your /etc/fstab file, replacing placeholders with your specific details. The options can be customized for network drives or non-critical mounts.

```text
UUID=<partition UUID> /media/foo somefs defaults 0 0
```

--------------------------------

### Install a Specific Hardware Profile with chwd

Source: https://wiki.cachyos.org/features/chwd/chwd

Install a specific hardware profile, such as 'amd', to ensure the correct drivers and packages are set up. The command will indicate success or failure.

```bash
sudo chwd -i amd
> Installing amd ...


> Successfully installed amd
```

--------------------------------

### Install sched-ext and tools (Bleeding Edge)

Source: https://wiki.cachyos.org/configuration/sched-ext

Installs the bleeding-edge branch of scx-scheds-git and scx-tools-git for the latest changes. This may include experimental schedulers not yet merged into the master branch.

```bash
sudo pacman -S scx-scheds-git scx-tools-git
```

--------------------------------

### Create systemd Mount File (tl;dr)

Source: https://wiki.cachyos.org/configuration/automount_with_fstab

Create a systemd mount file. The name should correspond to the mount path, with slashes replaced by hyphens.

```bash
micro /etc/systemd/system/mnt-foo.mount
```
Tokens:
Raw