aynish/helm - Sealight Git Forge

Find a file

Henrik Lissner 66868d48ac Bump emacs-overlay: 0a78ce6 -> 372abc5 home-manager: 87e2ec3 -> 1ee1d01 nixos-hardware: 3657e7c -> 0cb5491 nixpkgs-stable: d4c29df -> 2394284 nixpkgs-unstable: f72648d -> ff96a0f		2021-02-13 12:19:40 -05:00
bin	bin/hey: forward -iApeq to nix-env	2021-01-29 23:09:17 -05:00
config	Polish qutebrowser theme, integration, & config	2021-02-09 22:07:07 -05:00
hosts	kuro: add /usr/store mount	2021-02-12 11:21:29 -05:00
lib	Upgrade to qutebrowser 2.0.1	2021-02-02 04:08:01 -05:00
modules	Polish qutebrowser theme, integration, & config	2021-02-09 22:07:07 -05:00
overlays	Rewrite to use flakes	2020-10-11 01:31:33 -04:00
packages	Add adl module and packages	2021-02-09 22:00:17 -05:00
templates/minimal	Add flake templates and defaultApp	2021-01-22 20:01:55 -05:00
.gitignore	Rewrite to use flakes	2020-10-11 01:31:33 -04:00
default.nix	system.stateVersion = 21.03	2021-02-02 04:08:01 -05:00
flake.lock	Bump	2021-02-13 12:19:40 -05:00
flake.nix	Add stable channel; switch to nixos-unstable; bump	2021-02-11 13:13:21 -05:00
LICENSE	Update license year	2021-01-20 00:44:17 -05:00
README.md	Correct clone path in README	2021-01-29 14:23:18 -05:00
shell.nix	Update shell.nix to reflect recent changes	2021-01-26 22:58:47 -05:00

README.md

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.


Shell:	zsh + zgen
DM:	lightdm + lightdm-mini-greeter
WM:	bspwm + polybar
Editor:	Doom Emacs (and occasionally vim)
Terminal:	st
Launcher:	rofi
Browser:	firefox
GTK Theme:	Ant Dracula

Quick start

Yoink the latest stable build of NixOS 20.09.
Boot into the installer.
Do your partitions and mount your root to /mnt (for example)
Install these dotfiles:
nix-shell -p git nixFlakes
git clone https://github.com/hlissner/dotfiles /mnt/etc/nixos
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.
Reboot!
Change your root and $USER passwords!

Management

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

Command	Description
`hey rebuild`	Rebuild this flake (shortcut: `hey re`)
`hey upgrade`	Update flake lockfile and switch to it (shortcut: `hey up`)
`hey rollback`	Roll back to previous system generation
`hey gc`	Runs `nix-collect-garbage -d`. Use sudo to clean system profile
`hey push REMOTE`	Deploy these dotfiles to REMOTE (over ssh)
`hey check`	Run tests and checks for this flake
`hey show`	Show flake outputs of this repo

Frequently asked questions

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: