CachyOS FAQ Troubleshooting - ryzendew/Linux-Tips-and-Tricks GitHub Wiki

CachyOS FAQ & Troubleshooting Guide

This guide answers common questions about CachyOS and provides solutions to frequent problems.

Table of Contents

  1. General Questions
  2. Installation Questions
  3. Performance Questions
  4. Hardware Questions
  5. Software Questions
  6. Troubleshooting Common Issues
  7. Getting Help

General Questions

What is CachyOS?

CachyOS is an Arch Linux-based distribution optimized for performance. It includes:

  • Custom-compiled packages with CPU optimizations
  • BORE scheduler for better responsiveness
  • User-friendly installation and tools
  • Multiple desktop environment options

See CachyOS Getting Started Guide for more details.

Is CachyOS Right for Me?

CachyOS is good for:

  • Users who want better performance
  • Gamers who need low latency
  • Arch Linux users who want easier setup
  • Users with modern CPUs (2015+)

CachyOS may not be for you if:

  • You have very old hardware (pre-2015)
  • You need maximum stability over performance
  • You prefer Debian/Ubuntu-based systems

How is CachyOS Different from Arch Linux?

Similarities:

  • Based on Arch Linux
  • Uses pacman package manager
  • Rolling release model
  • Access to AUR (Arch User Repository)

Differences:

  • Performance optimizations (LTO, PGO, BOLT)
  • BORE scheduler by default
  • Easier installation (GUI installer)
  • Pre-configured desktop environments
  • Custom tools (chwd, CachyOS Hello)

Is CachyOS Stable?

Yes, CachyOS is stable:

  • Based on Arch Linux (stable base)
  • Optimizations don't affect stability
  • Well-tested packages
  • Active development and support

However:

  • Rolling release means frequent updates
  • Some packages may have bugs (same as Arch)
  • Always backup important data

Do I Need to Know Arch Linux?

No, but it helps:

  • CachyOS is more user-friendly than vanilla Arch
  • GUI installer makes installation easier
  • Tools simplify common tasks
  • Arch Linux knowledge is helpful but not required

Learning resources:

  • Arch Linux Wiki (useful for CachyOS too)
  • CachyOS Wiki
  • Community forums and Discord

Installation Questions

What Are the System Requirements?

Minimum:

  • 64-bit CPU (x86-64)
  • 2 GB RAM (4 GB recommended)
  • 20 GB disk space (40 GB recommended)

Recommended:

  • Modern CPU (2015+ for best optimizations)
  • 8 GB+ RAM
  • 50 GB+ disk space
  • SSD for system drive

See CachyOS Getting Started Guide for detailed requirements.

Can I Dual Boot with Windows?

Yes, dual booting is possible:

  • Shrink Windows partition first
  • Install CachyOS to free space
  • GRUB will detect both operating systems

Important:

  • Backup Windows data first
  • Disable Windows Fast Startup
  • Create Windows recovery media

See CachyOS Installation Guide for dual boot instructions.

Which Desktop Environment Should I Choose?

Recommendations:

  • KDE Plasma: Feature-rich, highly customizable
  • GNOME: Modern, minimalist
  • XFCE: Lightweight, traditional
  • i3: Tiling window manager, keyboard-driven
  • Wayfire: Modern Wayland compositor

Choose based on:

  • Your hardware (lightweight vs full-featured)
  • Your preferences (traditional vs modern)
  • Your workflow (mouse vs keyboard)

See Switching Desktop Environments for details.

How Long Does Installation Take?

Typical installation time:

  • Fast internet + SSD: 10-20 minutes
  • Average internet + HDD: 20-40 minutes
  • Slow internet: 40-60+ minutes

Factors affecting time:

  • Internet speed (packages download during install)
  • Disk speed (SSD vs HDD)
  • Selected desktop environment (some are larger)
  • System performance

Can I Install Without Internet?

Limited offline installation:

  • Some ISOs include packages
  • Most packages download during installation
  • Internet connection recommended

For offline installation:

  • Use full ISO with packages included
  • Or download packages beforehand
  • More complex setup

Performance Questions

How Much Faster is CachyOS?

Performance improvements vary:

  • Application startup: 5-15% faster
  • Gaming: Lower latency, smoother frame times
  • System responsiveness: Noticeably better
  • Compilation: 10-30% faster (with PGO)

Real-world benefits:

  • System feels more responsive
  • Lower input lag
  • Better multitasking
  • Smoother animations

See CachyOS Performance Guide for details.

Which CPU Optimization Level Should I Use?

General rule:

  • Use the highest level your CPU supports
  • x86-64-v3: 2015+ CPUs (recommended minimum)
  • x86-64-v4: 2016+ CPUs (better performance)
  • Zen4: AMD Ryzen 7000+ (best for supported CPUs)

Check your CPU:

lscpu

See CachyOS Performance Guide for CPU optimization details.

What is the BORE Scheduler?

BORE = Burst-Oriented Response Enhancer

What it does:

  • Prioritizes interactive tasks
  • Reduces input lag
  • Improves gaming performance
  • Better desktop responsiveness

Benefits:

  • Lower mouse/keyboard latency
  • Smoother gaming
  • Better multitasking

See CachyOS Performance Guide for scheduler details.

Can I Change the Scheduler?

Yes, multiple scheduler options:

  • BORE (default) - Best for desktop/gaming
  • EEVDF - Fair and efficient
  • sched-ext - Extensible framework
  • RT - Real-time scheduler

How to change:

  • Select during installation
  • Or install different kernel variant: 
    sudo pacman -S linux-cachyos-eevdf

Hardware Questions

Does CachyOS Support My Graphics Card?

NVIDIA:

  • Supported with proprietary drivers
  • Use chwd to install drivers: 
    sudo chwd -h -a nvidia

AMD:

  • Usually works out of box
  • Open-source drivers included
  • Good Linux support

Intel:

  • Integrated graphics work well
  • Usually no additional drivers needed

See CachyOS Tools Guide for chwd usage.

How Do I Install Graphics Drivers?

Use chwd (recommended):

# Detect hardware and install drivers
sudo chwd -h -a nvidia  # For NVIDIA

Or manually:

# For NVIDIA
sudo pacman -S nvidia

# For AMD (usually not needed)
# Drivers included in kernel

See CachyOS Tools Guide for details.

Does CachyOS Support Laptops?

Yes, CachyOS works on laptops:

  • Power management included
  • Battery optimization available
  • Touchpad support
  • Suspend/hibernate works

Laptop-specific features:

  • Power profiles
  • Battery monitoring
  • Backlight control
  • WiFi and Bluetooth support

What About WiFi and Bluetooth?

WiFi:

  • Most cards work out of box
  • Some may need firmware: 
    sudo pacman -S linux-firmware

Bluetooth:

  • Usually works automatically
  • May need to enable service: 
    sudo systemctl enable --now bluetooth

Software Questions

How Do I Install Software?

Using pacman (recommended):

# Search for packages
pacman -Ss package-name

What this command does:

  • pacman: The package manager (no sudo needed for searching)
  • -Ss: Search in package database
  • First S: Synchronize/search
  • Second s: Search in all repositories
  • package-name: What you're looking for (e.g., "firefox", "steam", "vlc")

Example:

pacman -Ss firefox

Example output:

extra/firefox 120.0-1
    Standalone web browser from mozilla.org
extra/firefox-i18n-en-us 120.0-1
    English (US) language pack for Firefox

Understanding the output:

  • extra/firefox: Package name and repository it's in
  • 120.0-1: Version number
  • Description: What the package does
# Install package
sudo pacman -S package-name

What this command does:

  • sudo: Administrator privileges (needed to install software)
  • pacman -S: Install package
  • package-name: Name of package to install

Example:

sudo pacman -S firefox

What happens:

  1. pacman checks if package exists
  2. Shows you what will be installed
  3. Lists dependencies (other packages needed)
  4. Asks for confirmation
  5. Downloads packages from internet
  6. Installs packages
  7. Shows summary

Example output:

resolving dependencies...
looking for conflicting packages...

Packages (3) to install:
  firefox 120.0-1
  mozilla-common 1.0-1
  nss 3.90-1

Total Download Size:    85.45 MiB
Total Installed Size:  245.32 MiB

:: Proceed with installation? [Y/n]

What to do:

  • Type Y and press Enter (or just press Enter - Y is default)
  • Wait for download and installation
  • Package will be installed and ready to use

Using AUR (Arch User Repository):

# Install AUR helper (yay is popular)
sudo pacman -S yay

What is AUR?

  • AUR: Arch User Repository
  • Community-maintained packages
  • Not officially supported by Arch/CachyOS
  • Contains software not in official repositories
  • Requires AUR helper to install

What is yay?

  • yay: Yet Another Yaourt (AUR helper)
  • Makes installing AUR packages easy
  • Similar to pacman but for AUR

What this command does:

  • Installs yay AUR helper
  • After installation, you can use yay to install AUR packages
# Install from AUR
yay -S package-name

What this command does:

  • yay: The AUR helper
  • -S: Install (same flag as pacman)
  • package-name: AUR package to install

Example:

yay -S google-chrome

What happens:

  1. yay searches AUR for the package
  2. Shows you the package and its information
  3. Downloads and builds the package (may take time)
  4. Installs the package
  5. Package is ready to use

Example output:

1 aur/google-chrome 120.0.6099.109-1
    The popular and trusted web browser by Google
==> Packages to install: google-chrome
==> [N]one [A]ll [Abort] (default=N):

What to do:

  • Type A and press Enter to install
  • Or type package number (1) and press Enter
  • Wait for build and installation (may take several minutes)

Important notes about AUR:

  • AUR packages are community-maintained (not official)
  • Always review AUR package pages before installing
  • Some packages may have security concerns
  • Building packages takes time and uses CPU

Using CachyOS Hello:

  • Launch CachyOS Hello
  • Browse packages
  • Click to install

See CachyOS Tools Guide for CachyOS Hello.

Can I Use Software from Other Distributions?

Generally no:

  • CachyOS uses Arch Linux packages
  • .deb (Debian/Ubuntu) packages won't work
  • .rpm (Fedora/RHEL) packages won't work

Alternatives:

  • Use Arch Linux packages (pacman)
  • Use AUR packages (yay, paru)
  • Use AppImage/Flatpak/Snap (universal formats)
  • Build from source

How Do I Update My System?

Regular updates (recommended method):

# Update package database and upgrade (always use -Syu together)
sudo pacman -Syu

Update frequency:

  • Update weekly or monthly
  • Check for security updates
  • Read update notes for breaking changes

Best practices:

  • Backup before major updates
  • Read update announcements
  • Test updates on non-critical systems first

Troubleshooting Common Issues

System Won't Boot After Installation

Symptoms:

  • Black screen
  • Bootloader errors
  • System doesn't start

Solutions:

  1. Check boot order:
  • Verify hard drive is first
  • Remove USB drive
  1. Check BIOS/UEFI:
  • Enable UEFI boot (if UEFI installation)
  • Disable Secure Boot (if causing issues)
  1. Boot from USB and repair:
  • Boot from installation USB
  • Mount your installation
  • Reinstall bootloader if needed
  1. Check partitions:
  • Verify partitions exist
  • Check filesystem integrity

See CachyOS Installation Guide troubleshooting section.

Graphics Issues (Black Screen, No Display)

Symptoms:

  • Black screen after boot
  • Display not working
  • Graphics errors

Solutions:

  1. Boot with safe graphics:
  • Select "Boot CachyOS (safe graphics)" from boot menu
  • Or add nomodeset kernel parameter

  1. Install correct drivers:

    # Use chwd
sudo chwd -h -a nvidia  # For NVIDIA

  2. Check graphics card:

    lspci | grep -i vga

  3. Try different display:

  • Different monitor
  • Different video port

Internet Not Working

Symptoms:

  • No network connection
  • Can't download packages
  • WiFi not connecting

Solutions:

  1. Check connection:

    # Check network interface
ip link

# Check connection status
ping -c 4 8.8.8.8

  2. Configure WiFi:

    # Use wifi-menu
wifi-menu

# Or use NetworkManager
nmtui

  3. Install network drivers:

    # Install firmware
sudo pacman -S linux-firmware

  4. Check services:

    # Enable NetworkManager
sudo systemctl enable --now NetworkManager

Audio Not Working

Symptoms:

  • No sound
  • Audio device not detected
  • Sound crackling

Solutions:

  1. Check audio service:

    # Enable PulseAudio
systemctl --user enable --now pulseaudio

  2. Check audio device:

    # List audio devices
aplay -l

  3. Install audio drivers:

    # Install ALSA and PulseAudio
sudo pacman -S alsa-utils pulseaudio pulseaudio-alsa

  4. Configure audio:

  • Use audio settings in desktop environment
  • Or use alsamixer in terminal

Slow Performance

Symptoms:

  • System feels slow
  • Applications lag
  • Poor performance

Solutions:

  1. Check CPU optimization:
  • Verify you're using correct optimization level
  • Check CPU supports optimizations

  1. Check disk:

    # Check disk health
sudo smartctl -a /dev/sda

  2. Check resources:

    # Check CPU and memory
htop

  3. Update system:

    sudo pacman -Syu

  4. Check for resource hogs:

  • Close unnecessary applications
  • Check startup programs
  • Monitor system resources

Package Installation Fails

Symptoms:

  • Can't install packages
  • Package errors
  • Dependency issues

Solutions:

  1. Update package database (use -Syu for full update):

    # Always use -Syu together to avoid dependency issues
sudo pacman -Syu

  2. Fix package database:

    sudo pacman -Syu

  3. Clear package cache:

    sudo pacman -Sc

  4. Check internet connection

  5. Try different mirror:

  • Edit /etc/pacman.d/mirrorlist
  • Or use reflector to update mirrors

Can't Log In

Symptoms:

  • Login screen appears but can't log in
  • Password not accepted
  • Login loop

Solutions:

  1. Check keyboard layout:
  • Verify correct layout
  • Check Caps Lock
  1. Reset password (advanced):
  • Boot from USB
  • Mount installation
  • Change password in chroot

  1. Check user account:

    # In recovery mode
# Verify user exists
cat /etc/passwd

  2. Check disk space:

    df -h
# Full disk can prevent login

Getting Help

Where Can I Get Help?

Official Resources:

Community:

  • Ask questions on forum
  • Join Discord for real-time help
  • Search existing discussions

Documentation:

  • Read the guides in this wiki
  • Check Arch Linux Wiki (useful for CachyOS)
  • Read package documentation

How to Ask for Help

When asking for help, provide:

  • Your hardware (CPU, GPU, RAM)
  • What you were trying to do
  • What went wrong
  • Error messages (if any)
  • What you've already tried

Good question format:

Hardware: Intel i7-9700K, NVIDIA RTX 3060
Issue: Graphics drivers not working
Error: [paste error message]
Tried: [list what you tried]

Reporting Bugs

If you find a bug:

  1. Check if it's already reported
  2. Gather information:
  • System information
  • Steps to reproduce
  • Error messages
  • Logs
  1. Report on GitHub or forum
  2. Be patient - developers are volunteers

Additional Resources

Summary

This FAQ covered:

  1. General questions - What is CachyOS, who is it for
  2. Installation questions - Requirements, dual boot, desktop environments
  3. Performance questions - Optimizations, schedulers, speed improvements
  4. Hardware questions - Graphics cards, drivers, laptops
  5. Software questions - Installing software, updates, compatibility
  6. Troubleshooting - Common issues and solutions
  7. Getting help - Where to find assistance

Key Takeaways:

  • CachyOS is optimized Arch Linux with better performance
  • Installation is user-friendly with GUI installer
  • Performance improvements are noticeable
  • Hardware support is good with proper drivers
  • Community is helpful and active
  • Always backup before making changes

This guide is based on the CachyOS Wiki and common community questions. For the most up-to-date information, always refer to the official CachyOS documentation and community resources.