### 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 ``` -------------------------------- ### EXT4 Install Partition Selection Source: https://wiki.cachyos.org/features/cachy_chroot Example output showing partition detection for an EXT4 installation. Use arrow keys to select the root partition. ```bash 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 ``` -------------------------------- ### Use tldr for Command Examples Source: https://wiki.cachyos.org/configuration/post_install_setup This example shows how to use tldr to get a quick, simplified explanation and usage example for a command, such as 'java'. ```bash tldr java Execute a ".jar" program: java -jar filename.jar ``` -------------------------------- ### Install EasyEffects and Plugins Source: https://wiki.cachyos.org/configuration/general_system_tweaks Install EasyEffects and its essential audio plugins for enhanced sound quality on your laptop speakers. This setup is recommended for applying custom audio configurations. ```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 ``` -------------------------------- ### Application Arguments Example Source: https://wiki.cachyos.org/configuration/gaming Example of application-specific arguments that can be appended to launch options. ```bash %command% -dx11 ``` -------------------------------- ### Wrapper Example Source: https://wiki.cachyos.org/configuration/gaming Examples of wrappers that can be used in launch options to modify application execution. ```bash mangohud --dlsym ``` ```bash gamescope -W 1680 -H 1050 -w 1280 -h 720 -S fit -F fsr --mangoapp -- ``` -------------------------------- ### Environment Variable Example Source: https://wiki.cachyos.org/configuration/gaming Examples of environment variables that can be set for launch options. ```bash PROTON_DXVK_D3D8=1 ``` ```bash DXVK_HUD="fps,memory,version,api" ``` -------------------------------- ### Complete Launch Option Example Source: https://wiki.cachyos.org/configuration/gaming A comprehensive example combining environment variables, wrappers, the command, and application arguments. ```bash __GL_SHADER_DISK_CACHE_SKIP_CLEANUP=1 prime-run game-performance %command% -dx11 ``` -------------------------------- ### 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 and Enable thermald Service Source: https://wiki.cachyos.org/configuration/general_system_tweaks Installs the thermald package and enables its service to start automatically on boot. Use this to manage thermal sensors and apply cooling actions on Intel systems. ```bash sudo pacman -S thermald sudo systemctl enable --now thermald.service ``` -------------------------------- ### CachyOS BTRFS Install Partition Selection Source: https://wiki.cachyos.org/features/cachy_chroot Example output showing partition detection for a CachyOS BTRFS installation. Use arrow keys to select the root partition. ```bash 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 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 ``` -------------------------------- ### Pacman Configuration Example Source: https://wiki.cachyos.org/configuration/post_install_setup An example configuration snippet for `pacman.conf`, showing how to define repositories and include other configuration files like the offline update list. ```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 ``` -------------------------------- ### 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 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 ``` -------------------------------- ### 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 New DE/WM and CachyOS Settings Package Source: https://wiki.cachyos.org/configuration/desktop_environments/switch_desktop Installs a new desktop environment or window manager along with its corresponding CachyOS settings package, for example, i3wm and cachyos-i3wm-settings. ```bash sudo pacman -Syu i3-wm cachyos-i3wm-settings ``` -------------------------------- ### Install sbctl Package Source: https://wiki.cachyos.org/configuration/secure_boot_setup Install the sbctl package, a user-friendly secure boot key manager. ```bash sudo pacman -S sbctl ``` -------------------------------- ### Enable and Start AppArmor Service Source: https://wiki.cachyos.org/configuration/post_install_setup Enables the AppArmor service to start on boot and starts it immediately. ```bash systemctl enable --now apparmor.service ``` -------------------------------- ### 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"] ``` -------------------------------- ### 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 Noctalia v5 Beta/Git Source: https://wiki.cachyos.org/configuration/desktop_environments/hyprland Installs the Noctalia v5 beta or -git version. This involves installing the base package and then building from source if using the -git version. ```bash sudo pacman -Syu noctalia ``` ```bash paru -Syu noctalia-git ``` ```bash shelly -AI noctalia-git ``` -------------------------------- ### Install GRUB with Secure Boot Support Source: https://wiki.cachyos.org/configuration/secure_boot_setup Use this command to install GRUB with secure boot support using CA Keys. ```bash sudo grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=cachyos --modules="tpm" --disable-shim-lock ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 systemd-boot Source: https://wiki.cachyos.org/cachyos_basic/faq Command to install the systemd-boot bootloader. This is typically used for UEFI systems. ```bash sudo bootctl install ``` -------------------------------- ### Install Limine Bootloader (UEFI/MBR) Source: https://wiki.cachyos.org/cachyos_basic/faq Commands to install the Limine bootloader. Use `limine-install` for UEFI and `limine bios-install` for MBR/BIOS systems. Replace `sdX` with your disk identifier for MBR/BIOS. ```bash sudo limine-install ``` ```bash sudo limine bios-install /dev/sdX # Replace sdX with your disk e.g. sda ``` -------------------------------- ### Install cachy-chroot Source: https://wiki.cachyos.org/features/cachy_chroot Ensure you have the latest version of cachy-chroot installed by running this command in the live environment. ```bash pacman -Sy cachy-chroot ``` -------------------------------- ### Install Gaming Meta-Package Source: https://wiki.cachyos.org/configuration/gaming Installs the core gaming-related libraries and dependencies. Use this to ensure all necessary components for gaming are present. ```bash sudo pacman -S cachyos-gaming-meta ``` -------------------------------- ### 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 ``` -------------------------------- ### 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" ``` -------------------------------- ### 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"] ``` -------------------------------- ### Run cachy-chroot Source: https://wiki.cachyos.org/features/cachy_chroot Execute the cachy-chroot command to begin the process of accessing your installed system. ```bash cachy-chroot ``` -------------------------------- ### Enable Global Menu Support Source: https://wiki.cachyos.org/configuration/post_install_setup Installs necessary packages to enable global menu support for applications. Restart the application after installation for changes to take effect. ```bash # To enable global menu support, run the command and restart the app. sudo pacman -S appmenu-gtk-module libdbusmenu-glib ``` -------------------------------- ### Install NVIDIA Modules Source: https://wiki.cachyos.org/cachyos_basic/faq Install the necessary NVIDIA modules if they are missing, which can cause 'module not found' errors during system initialization. ```bash sudo pacman -S nvidia ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 ``` -------------------------------- ### Install and Enable switcheroo-control Source: https://wiki.cachyos.org/configuration/dual_gpu Install the `switcheroo-control` package and enable its systemd service. This is required for desktop environments like KDE Plasma and GNOME to manage discrete graphics. ```bash sudo pacman -S switcheroo-control sudo systemctl enable --now switcheroo-control ``` -------------------------------- ### Install Custom OBS Studio Package Source: https://wiki.cachyos.org/configuration/general_system_tweaks Install the `obs-studio-browser` package, which includes patches for common issues like CUDA errors and virtual camera problems. This is recommended over the standard `obs-studio` package. ```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". ``` -------------------------------- ### Install protonup-qt with Pacman Source: https://wiki.cachyos.org/configuration/gaming Install the protonup-qt package using pacman. This utility helps manage Proton versions for Steam. ```bash sudo pacman -S protonup-qt ``` -------------------------------- ### Install CachyOS Hyprland Settings Source: https://wiki.cachyos.org/configuration/desktop_environments/hyprland Installs the CachyOS Hyprland configuration package. Use this if you are setting up Hyprland for the first time or migrating from a different CachyOS DE/WM. ```bash sudo pacman -S cachyos-hypr-noctalia ``` -------------------------------- ### 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" ``` -------------------------------- ### 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 ``` -------------------------------- ### Install Gaming Applications Meta-Package Source: https://wiki.cachyos.org/configuration/gaming Installs popular gaming tools, launchers, and stores. This meta-package includes applications like Steam, Lutris, and MangoHud. ```bash sudo pacman -S cachyos-gaming-applications ``` -------------------------------- ### 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' ``` -------------------------------- ### Install CachyOS Samba Settings Source: https://wiki.cachyos.org/configuration/post_install_setup Installs a package providing convenient smb.conf settings for CachyOS users to configure Samba shares. ```bash sudo pacman -S cachyos-samba-settings ``` -------------------------------- ### 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 Filled systemd Mount File Source: https://wiki.cachyos.org/configuration/automount_with_fstab An example of a completed systemd mount file for a games drive. Ensure 'What' contains the partition's UUID, 'Where' is the mount point, 'Type' is the filesystem, and 'Options' are set appropriately. ```ini [Unit] Description=Mount games drive (/home/user/games) [Mount] What=UUID=4e55896f-3f1f-4bc5-aa8a-fec099689cd9 Where=/home/user/games Type=ext4 Options=defaults,exec,rw,noatime [Install] WantedBy=multi-user.target ``` -------------------------------- ### Check sbctl Status Source: https://wiki.cachyos.org/configuration/secure_boot_setup Check the current status of sbctl, including installation, setup mode, and secure boot status. ```bash sudo sbctl status ``` -------------------------------- ### Start Pacman Offline Update Preparation Source: https://wiki.cachyos.org/configuration/post_install_setup Initiates a one-time preparation for offline updates, synchronizing databases and downloading updates without installing them. ```bash sudo systemctl start pacman-offline-prepare.service ``` -------------------------------- ### 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= Where=/mnt/foo Type=somefs Options=defaults [Install] WantedBy=multi-user.target ``` -------------------------------- ### Install Flatpak Package Manager Source: https://wiki.cachyos.org/configuration/post_install_setup Installs the Flatpak package manager, a prerequisite for installing applications like gearlever via Flathub. ```bash sudo pacman -S flatpak ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 ``` -------------------------------- ### 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. ``` -------------------------------- ### 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 │ ``` -------------------------------- ### Install rEFInd Bootloader Source: https://wiki.cachyos.org/cachyos_basic/faq Command to install the rEFInd bootloader, typically used for UEFI systems. ```bash sudo refind-install ``` -------------------------------- ### Install FUSE2 for AppImages Source: https://wiki.cachyos.org/configuration/post_install_setup Installs the FUSE2 package, which may be required for running certain AppImages. ```bash sudo pacman -S fuse2 ``` -------------------------------- ### 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 < /media/foo somefs defaults 0 0 ``` -------------------------------- ### 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 ``` -------------------------------- ### View Scheduler Help Source: https://wiki.cachyos.org/configuration/sched-ext Use this command to see available flags and a brief description of what they do for a specific scheduler. ```bash scx_rusty --help ``` -------------------------------- ### 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 ``` -------------------------------- ### Example GPG Verification Output Source: https://wiki.cachyos.org/cachyos_basic/download This is an example of a 'Good signature' output from the GPG verification process, indicating a genuine ISO file. ```text gpg: Signature made dom 08 mar 2026 10:39:18 -03 gpg: using RSA key 882DCFE48E2051D48E2562ABF3B607488DB35A47 gpg: Good signature from "CachyOS " [unknown] gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: 882D CFE4 8E20 51D4 8E25 62AB F3B6 0748 8DB3 5A47 ``` -------------------------------- ### Edit limine-snapper-sync.conf Source: https://wiki.cachyos.org/configuration/btrfs_snapshots Opens the limine-snapper-sync configuration file for editing using nano. ```bash sudo nano /etc/limine-snapper-sync.conf ``` -------------------------------- ### Install pacman-offline Package Source: https://wiki.cachyos.org/configuration/post_install_setup Installs the `pacman-offline` package, which enables offline system upgrades by integrating with systemd. This command requires root privileges. ```bash sudo pacman -S pacman-offline ``` -------------------------------- ### QEMU Command for Virtio-Venus Source: https://wiki.cachyos.org/virtualization/virtio-venus Use this command to launch a QEMU virtual machine with Virtio-Venus enabled for 3D acceleration. Ensure your VM is configured with appropriate hardware and paths. ```bash qemu-system-x86_64 \ -enable-kvm \ -M q35 \ -smp 6 \ -m 12G \ -cpu host \ -net nic,model=virtio \ -net user,hostfwd=tcp::2222-:22 \ -device virtio-sound-pci,audiodev=my_audiodev -audiodev pipewire,id=my_audiodev \ -device virtio-vga-gl,hostmem=4G,blob=true,venus=true \ -vga none \ -display gtk,gl=on,show-cursor=on \ -usb -device usb-tablet \ -object memory-backend-memfd,id=mem1,size=12G \ -machine memory-backend=mem1 \ -drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2/x64/OVMF_CODE.secboot.4m.fd \ -drive if=pflash,format=raw,file=.config/libvirt/qemu/nvram/archlinux_VARS.fd \ -drive file=.local/share/libvirt/images/archlinux.qcow2 ```