README.md

NixOS Dotfiles

My Personal NixOS Config

Warning

Use at your own risk. It works for me, but it may not work for you. At least not without adjustments.

---

Features

• XFCE desktop environment
• BSPWM window manager
• Brave browser
• Kitty terminal
• Zsh shell
• etc.

Components

• configuration.nix (and variants)

  Root config: Avoid modifying unless really needed (like changing username, groups, etc.).

  Variants: -darwin for nix-darwin, and -surface for Surface devices

• system/ (directory)

  System configs: Configure various system components, like home-manager, unfree software, system-wide packages, etc.

• packages/ (directory)

  Package configs: Install and configure various software for the user.

---

Installation

Caution

The installation scripts use sudo. Please read the scripts and included comments before running to ensure you understand what they're doing and acknowledge that you trust them. Else, manually run the commands or install otherwise at your own risk.

NixOS

Important

Run export SURFACE_KERNEL=1 before running the following script if you’re using a Surface device and you want the linux-surface kernel.

Run the install.sh script:

curl -sS "https://raw.githubusercontent.com/cybardev/nixos-dotfiles/refs/heads/main/install.sh" | bash -e

macOS

Run the install-mac.sh script:

curl -sS "https://raw.githubusercontent.com/cybardev/nixos-dotfiles/refs/heads/main/install-mac.sh" | bash -e

---

Screenshots