cachyos-setup/README.md

CachyOS Post-Install Setup

Personal CachyOS + GNOME post-install assistant for Jose Lago.

What it does

• Updates CachyOS safely.
• Installs hardware drivers with chwd.
• Installs desktop apps:
  • Brave
  • Chromium
  • FileZilla
  • Thunderbird
  • LibreOffice Fresh
  • VS Code
  • Docker
  • Telegram
  • Signal
  • Vesktop
  • Sone
  • WireGuard GUI
  • Impression
  • Extension Manager
  • OpenCode
• Sets Brave as the default browser.
• Force-installs and pins Brave extensions:
  • Bitwarden
  • Floccus
• Installs Ghostty and configures:
  • Zsh
  • Oh My Zsh
  • Powerlevel10k
  • Fastfetch
• Configures Git identity:
  • Jose Lago
  • jose@lago.dev
• Installs Tela Circle icon theme, all variants.
• Configures GNOME shortcuts:
  • Super + Enter: Ghostty
  • Super + B: Brave
  • Super + E: VS Code
  • Super + F: Files
  • Super + M: Thunderbird
  • Super + T: Telegram
  • Super + S: Signal
  • Super + W: WireGuard GUI
  • Super + I: Impression
  • Super + Q: Close window
• Keeps Super + Space free for Search Light.
• Keeps Super + V free for clipboard history.
• Optionally configures persistent Unraid NAS mounts.

Usage

Run as normal user, not root:

chmod +x post-install-cachyos.sh
./post-install-cachyos.sh

After running

Reboot or log out/in to fully apply:

• Default shell change
• GNOME keyboard shortcuts
• Brave managed policies
• Docker group membership
• GDM autologin
• GNOME extensions
• Terminal configuration

Optional NAS

The script asks whether to configure NAS mounts.

If enabled, credentials are stored at:

/etc/samba/credentials-unraid

Mount points:

/mnt/nas/isos
/mnt/nas/Data

Dotfiles

System setup and personal config are separated:

• post-install-cachyos.sh installs packages and system-level setup.
• cachyos-dotfiles syncs user configuration, GNOME settings, extensions, icons, dock order, shortcuts, Ghostty, Zsh, Fastfetch, and related desktop preferences.

Recommended flow

On a fresh CachyOS install:

./post-install-cachyos.sh

Then import personal settings from dotfiles:

cd ~/Projects/cachyos-dotfiles
git pull
./import.sh

When the desktop is perfect and you want to save it:

cd ~/Projects/cachyos-dotfiles
./export.sh

Notes

Do not store secrets in dotfiles.

Keep these out of Git:

• NAS credentials
• SSH private keys
• API tokens
• Browser cookies
• Password stores
• Thunderbird profiles