CachyOS Installation Guide

Step 1: Boot from Installation Media

  1. Download the latest CachyOS ISO from the releases page.
  2. Flash it to your Ventoy USB and boot. The CachyOS Live OS will start automatically.

Step 2: Execute the Installer

  1. Start the Install Launcher from the live environment.
  2. Follow the on-screen instructions to format and install the OS.
  3. Once the installation is complete, remove the USB drive and restart your system.

Step 3: First Boot & Basic Tweaks

  1. Boot into your fresh CachyOS installation.
  2. Disable mouse acceleration (because it's annoying).
  3. Check your sound settings to ensure audio is working.
  4. Install your preferred browser (e.g., Brave).

Step 4: Core System Configuration

  1. Configure passwordless sudo for the installer group (using please):
    please vim /etc/sudoers.d/10-installer
    # Add the NOPASSWD tag to your user/group
  2. Update your mirrorlist for optimal speeds:
    mirror
  3. Enable the SSH daemon:
    please systemctl enable sshd --now

Step 5: Shell & Environment Upgrades (Fish)

  1. Update system packages and install zoxide using paru:
    paru -Syu
    paru -S zoxide
    echo 'eval "$(zoxide init --cmd cd fish)"' >> ~/.fish_profile
  2. Install and configure tty-clock:
    paru -S tty-clock
    alias clockme='tty-clock -c -C 3' -s

Step 6: Configure Starship Prompt

  1. Install Starship:
    paru -S starship
    echo 'eval "$(starship init fish)"' >> ~/.fish_profile
  2. Generate and edit the configuration:
    starship print-config > ~/.config/starship.toml
    # Edit ~/.config/starship.toml to make your changes (disable git status, extra new line... etc)

Step 7: Install Neovim

  1. Install Neovim and set aliases:
    paru -S neovim
    alias vi='nvim' -s
    alias vim='nvim' -s