cyper-nix/README.md

DerGrumpfs Nix Configuration

A unified Nix configuration for both NixOS and macOS using flakes, nix-darwin, and Home Manager.

About

A single repository managing both machines declaratively with Nix. Shared home-manager configuration across platforms with platform-specific modules where needed.

Author: Phil Keier

Machines

Hostname	Platform	Architecture
cyper-desktop	NixOS	x86_64-linux
cyper-mac	macOS	x86_64-darwin

Prerequisites

NixOS

Nix is available out of the box. Enable flakes in your configuration.

macOS

Install Nix using the Determinate Systems installer.

Note: Homebrew is managed declaratively via nix-homebrew — if already installed it will auto-migrate, otherwise it is installed automatically.

Quick Start

Clone

git clone https://github.com/DerGrumpf/nix ~/.config/nix
cd ~/.config/nix

Customize

Replace placeholders in home/git.nix:

• DerGrumpf → your Git username
• phil.keier@hotmail.com → your Git email

Apply

# NixOS
sudo nixos-rebuild switch --flake .#cyper-desktop

# macOS
darwin-rebuild switch --flake .#cyper-mac

# Or after initial setup on either machine
nix-switch

Project Structure

graph TD
    flake[flake.nix] --> desktop[nixosConfigurations<br/>cyper-desktop]
    flake --> mac[darwinConfigurations<br/>cyper-mac]

    desktop --> nixos[nixos/<br/>NixOS system modules]
    desktop --> hd[hosts/cyper-desktop/<br/>hardware + networking]
    desktop --> home[home/<br/>shared home-manager]

    mac --> darwin[darwin/<br/>macOS system modules]
    mac --> hm[hosts/cyper-mac/<br/>host specific]
    mac --> home

    home --> shared[shared<br/>packages, git, shell, python<br/>nixvim, nixcord, spicetify<br/>floorp, obsidian]
    home --> deskmod[desktop/]

    deskmod --> dlinux[Linux only<br/>hyprland, niri<br/>waybar, rofi<br/>gtk, qt, onlyoffice<br/>xdg, waypaper]
    deskmod --> dmac[macOS only<br/>sketchybar]

Secrets

Secrets are managed with sops-nix and age encryption. The age key must be present at:

• Linux: ~/.config/sops/age/keys.txt
• macOS: ~/.config/sops/age/keys.txt

Useful Links

• Nix manual
• nix-darwin docs
• Home Manager options
• sops-nix
• nixvim

TODO

• Verify Linux build on cyper-desktop

  sudo nixos-rebuild switch --flake ~/.config/nix#cyper-desktop

• Verify Darwin build on cyper-mac

  darwin-rebuild switch --flake ~/.config/nix#cyper-mac

• Commit and push all current changes

  git add -A && git commit -m "unify configs" && git push

• Test nix-check alias on both machines
• Test nix-switch alias on both machines after initial builds succeed
• Verify sops secrets are accessible on Darwin

  echo $GROQ_API_KEY

• Verify sketchybar loads correctly with lua config on macOS