NixOS Configuration

Personal NixOS and nix-darwin configuration managed with flakes.

Hosts

river (NixOS Desktop)

• Platform: x86_64-linux
• Hardware: ASUS TUF X870-PLUS WIFI motherboard with AMD Ryzen CPU
• GPU: NVIDIA RTX (proprietary drivers)
• Storage: ZFS with encryption
• Desktop: Hyprland (Wayland compositor)
• Display: Multi-monitor setup (DP-3 primary at 2560x1440, DP-2 secondary at 1920x1080)

serenity (macOS Laptop)

• Platform: aarch64-darwin
• OS: macOS with nix-darwin
• Window Manager: AeroSpace

Quick Start

Build and Switch

The repository includes a smart switch function that detects your OS and runs the appropriate rebuild command:

# Automatically detects platform and rebuilds
switch

# Or use platform-specific commands:
# NixOS:
sudo nixos-rebuild switch --flake ~/.config/nix

# macOS (nix-darwin):
sudo darwin-rebuild switch --flake ~/.config/nix

Update Flake Inputs

cd ~/.config/nix
nix flake update
switch

Secrets Management

Secrets are managed using sops-nix with age encryption.

Key Locations

• NixOS: /home/ben/.config/sops/age/keys.txt
• macOS: /Users/ben/Library/Application Support/sops/age/keys.txt

Editing Secrets

# Edit shared secrets
sops secrets/shared/secrets.yaml

# Edit host-specific secrets
sops secrets/river/secrets.yaml

Available Secrets

• anthropic_api_key - Claude API key
• homebrew_github_api_token - GitHub token for Homebrew
• gemini_api_key - Google Gemini API key
• rclone_gdrive_token - Google Drive OAuth token for rclone

Repository Structure

.
├── flake.nix              # Main flake configuration
├── home/                  # Home Manager modules
│   ├── hyprland.nix      # Wayland compositor config
│   ├── waybar.nix        # Status bar config
│   ├── waybar-scripts.nix # Waybar helper scripts
│   ├── syncthing.nix     # File synchronization
│   ├── session.nix       # Session paths and variables
│   ├── zsh.nix           # Shell configuration
│   └── ...               # Other home modules
├── hosts/                 # Host-specific configurations
│   ├── river/            # NixOS desktop
│   │   ├── configuration.nix
│   │   ├── hardware-configuration.nix
│   │   ├── home.nix
│   │   └── secrets.nix
│   └── serenity/         # macOS laptop
│       ├── configuration.nix
│       └── home.nix
├── packages.nix          # Common packages
└── secrets/              # Encrypted secrets (sops)
    └── shared/
        └── secrets.yaml

Key Features

System Monitoring

• Prometheus: System metrics collection via vmagent
• Node Exporter: CPU, memory, disk metrics
• NVIDIA GPU Exporter: GPU metrics (NVIDIA cards)
• Custom Fan Control: Dynamic fan curve based on CPU temperature

Desktop Environment (river)

• Compositor: Hyprland with blur, animations, and multi-monitor support
• Status Bar: Waybar with custom scripts
• Application Launcher: Rofi and Walker
• Notifications: SwayNC (swaync)
• Terminal: Ghostty
• File Manager: Nemo
• Theming: Catppuccin Mocha

Development Tools

• Editor: Neovim
• Shell: Zsh with oh-my-zsh
• Multiplexer: Tmux with tmuxinator
• Version Managers: mise (replaces asdf)
• Fuzzy Finder: fzf
• Directory Jumper: z-lua

Syncthing Folders

The following directories are synced between hosts:

• ~/.config/nix - This configuration repository
• ~/Development - Development projects
• ~/Dotfiles - Additional dotfiles

Custom Waybar Scripts

Located in home/waybar/scripts/, packaged as proper derivations:

• power-menu.sh - Power options (suspend, shutdown, reboot, logout)
• audio-output-menu.sh - Audio output device switcher
• usb-monitor.sh - USB device notifications
• usb-menu.sh - USB device menu
• gamma-control.sh - Screen color temperature control

Hyprland Keybindings

See home/hyprland.nix for full list. Some highlights:

• Super + Return - Terminal
• Super + B - Browser
• Super + S - Power menu
• Super + A - Audio output menu
• Super + V - Clipboard manager
• Super + [1-9] - Switch workspace

Contributing

See CONTRIBUTING.md for guidelines on:

• Code style and formatting
• Path handling (use ${config.home.homeDirectory})
• Secret management
• Module organization

License

Personal configuration - use at your own risk.