Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

• Updated input 'agenix':
    'github:ryantm/agenix/7e5e58b98c3dcbf497543ff6f22591552ebfe65b' (2022-05-16)
  → 'github:ryantm/agenix/c96da5835b76d3d8e8d99a0fec6fe32f8539ee2e' (2022-09-03)
• Updated input 'emacs-overlay':
    'github:nix-community/emacs-overlay/5cf9609f0bb8567f2f5c951fcd31b62a2f0302f5' (2022-08-24)
  → 'github:nix-community/emacs-overlay/b50178f76a7868d0aca28278451141269df137fe' (2022-09-16)
• Updated input 'home-manager':
    'github:rycee/home-manager/b382b59faf717c5b36f4cd8e1c5d96cdabd382c9' (2022-08-24)
  → 'github:rycee/home-manager/5427f3d1f0ea4357cd4af0bffee7248d640c6ffc' (2022-09-16)
• Updated input 'nixos-hardware':
    'github:nixos/nixos-hardware/12620020f76b1b5d2b0e6fbbda831ed4f5fe56e1' (2022-08-13)
  → 'github:nixos/nixos-hardware/a0df6cd6e199df4a78c833c273781ea92fa62cfb' (2022-09-15)
• Updated input 'nixpkgs':
    'github:NixOS/nixpkgs/f034b5693a26625f56068af983ed7727a60b5f8b' (2022-08-24)
  → 'github:NixOS/nixpkgs/1158501e7c7cba26d922723cf9f70099995eb755' (2022-09-14)
• Updated input 'nixpkgs-unstable':
    'github:NixOS/nixpkgs/963d27a0767422be9b8686a8493dcade6acee992' (2022-08-23)
  → 'github:NixOS/nixpkgs/454887a35de6317a30be284e8adc2d2f6d8a07c4' (2022-09-15)

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
April 28, 2022 17:41
October 11, 2020 01:31
April 28, 2022 19:47
January 5, 2022 12:31
January 20, 2021 00:44
September 19, 2022 16:10

Made with Doom Emacs NixOS Unstable

Hey, you. You're finally awake. You were trying to configure your OS declaratively, right? Walked right into that NixOS ambush, same as us, and those dotfiles over there.

Disclaimer: This is not a community framework or distribution. It's a private configuration and an ongoing experiment to feel out NixOS. I make no guarantees that it will work out of the box for anyone but myself. It may also change drastically and without warning.

Until I can bend spoons with my nix-fu, please don't treat me like an authority or expert in the NixOS space. Seek help on the NixOS discourse instead.

Shell: zsh + zgenom
DM: lightdm + lightdm-mini-greeter
WM: bspwm + polybar
Editor: Doom Emacs
Terminal: st
Launcher: rofi
Browser: firefox
GTK Theme: Ant Dracula

Quick start

  1. Acquire NixOS 21.11 or newer:

    # Yoink nixos-unstable
    wget -O nixos.iso
    # Write it to a flash drive
    cp nixos.iso /dev/sdX
  2. Boot into the installer.

  3. Switch to root user: sudo su -

  4. Do your partitions and mount your root to /mnt (for example).

  5. Install these dotfiles:

    nix-shell -p git nixFlakes
    # Set HOST to the desired hostname of this system
    # Set USER to your desired username (defaults to hlissner)
    git clone /etc/dotfiles
    cd /etc/dotfiles
    # Create a host config in `hosts/` and add it to the repo:
    mkdir -p hosts/$HOST
    nixos-generate-config --root /mnt --dir /etc/dotfiles/hosts/$HOST
    rm -f hosts/$HOST/configuration.nix
    cp hosts/kuro/default.nix hosts/$HOST/default.nix
    vim hosts/$HOST/default.nix  # configure this for your system; don't use it verbatim!
    git add hosts/$HOST
    # Install nixOS
    USER=$USER nixos-install --root /mnt --impure --flake .#$HOST
    # If you get 'unrecognized option: --impure', replace '--impure' with 
    # `--option pure-eval no`.
    # Then move the dotfiles to the mounted drive!
    mv /etc/dotfiles /mnt/etc/dotfiles
  6. Then reboot and you're good to go!

⚠️ Don't forget to change your root and $USER passwords! They are set to nixos by default.


And I say, bin/hey, what's going on?

Usage: hey [global-options] [command] [sub-options]

Available Commands:
  check                  Run 'nix flake check' on your dotfiles
  gc                     Garbage collect & optimize nix store
  generations            Explore, manage, diff across generations
  help [SUBCOMMAND]      Show usage information for this script or a subcommand
  rebuild                Rebuild the current system's flake
  repl                   Open a nix-repl with nixpkgs and dotfiles preloaded
  rollback               Roll back to last generation
  search                 Search nixpkgs for a package
  show                   [ARGS...]
  ssh HOST [COMMAND]     Run a bin/hey command on a remote NixOS system
  swap PATH [PATH...]    Recursively swap nix-store symlinks with copies (and back).
  test                   Quickly rebuild, for quick iteration
  theme THEME_NAME       Quickly swap to another theme module
  update [INPUT...]      Update specific flakes or all of them
  upgrade                Update all flakes and rebuild system

    -d, --dryrun                     Don't change anything; perform dry run
    -D, --debug                      Show trace on nix errors
    -f, --flake URI                  Change target flake to URI
    -h, --help                       Display this help, or help for a specific command
    -i, -A, -q, -e, -p               Forward to nix-env

Frequently asked questions