pimeys / dotfiles-1 Goto Github PK

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.

1. Yoink the latest build of NixOS 21.05.
2. Boot into the installer.
3. Do your partitions and mount your root to /mnt (for example)
4. Install these dotfiles:
5. nix-shell -p git nixFlakes
6. git clone https://github.com/hlissner/dotfiles /mnt/etc/nixos
7. Install NixOS: nixos-install --root /mnt --flake /mnt/etc/nixos#XYZ, where XYZ is the host you want to install. Use #generic for a simple, universal config, or create a sub-directory in hosts/ for your device. See host/kuro for an example.
8. Reboot!
9. Change your root and $USER passwords!

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

• Why NixOS?

  Because declarative, generational, and immutable configuration is a godsend when you have a fleet of computers to manage.

• How do I change the default username?

  1. Set USER the first time you run nixos-install: USER=myusername nixos-install --root /mnt --flake /path/to/dotfiles#XYZ
  2. Or change "hlissner" in modules/options.nix.

• Why did you write bin/hey?

  I'm nonplussed by the user story for nix's CLI tools and thought fixing it would be more productive than complaining about it on the internet. Then I thought, why not do both?

• How 2 flakes?

  Would it be the NixOS experience if I gave you all the answers in one, convenient place?

  No, but here are some resources that helped me:

  • A three-part tweag article that everyone's read.
  • An overengineered config to scare off beginners.
  • A minimalistic config for scared beginners.
  • A nixos wiki page that spells out the format of flake.nix.
  • Official documentation that nobody reads.
  • Some great videos on general nixOS tooling and hackery.
  • A couple flake configs that I may have shamelessly rummaged through.
  • Some notes about using Nix
  • What helped me figure out generators (for npm, yarn, python and haskell)
  • What y'all will need when Nix drives you to drink.