Minor refactors & readme revision

README.md

@@ -28,15 +28,17 @@
 
 ## Quick start
 
-1. Yoink [NixOS 20.09][nixos] (must be newer than Sept 12, 2020 for `nixos-install --flake`).
+1. Yoink the latest stable build of [NixOS 20.09][nixos].
 2. Boot into the installer.
-3. Do your partitions and mount your root to `/mnt`
+3. Do your partitions and mount your root to `/mnt` ([for example](hosts/kuro/README.org))
-4. `git clone https://github.com/hlissner/dotfiles /mnt/etc/nixos`
+4. Install these dotfiles:
-5. Install NixOS: `nixos-install --root /mnt --flake /mnt/etc/nixos#XYZ`, where
+5. `nix-shell -p git nixFlakes`
-   `XYZ` is your hostname.  Use `#generic` for a simple, universal config.
+6. `git clone https://github.com/hlissner/dotfiles /mnt/etc/dotfiles`
-6. OPTIONAL: Create a sub-directory in `hosts/` for your device. See [host/kuro]
+7. Install NixOS: `nixos-install --root /mnt --flake /mnt/etc/nixos#XYZ`, where
-   as an example.
+   `XYZ` is [the host you want to install](hosts/).  Use `#generic` for a
-7. Reboot!
+   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!
 
 ## Management
 
@@ -62,14 +64,9 @@ And I say, `bin/hey`. [What's going on?](http://hemansings.com/)
 + **How do I change the default username?**
 
   1. Set `USER` the first time you run `nixos-install`: `USER=myusername
-     nixos-install --root /mnt --flake #XYZ`
+     nixos-install --root /mnt --flake /path/to/dotfiles#XYZ`
   2. Or change `"hlissner"` in modules/options.nix.
   
-+ **How do I "set up my partitions"?**
-
-  My main host [has a README](hosts/kuro/README.org) you can use as a reference.
-  I set up an EFI+GPT system and partitions with `parted` and `zfs`.
-  
 + **Why did you write bin/hey?**
 
   I'm nonplussed by the user story for nix's CLI tools and thought fixing it

lib/nixos.nix

@@ -14,7 +14,7 @@ in {
           networking.hostName = mkDefault (removeSuffix ".nix" (baseNameOf path));
         }
         (filterAttrs (n: v: !elem n [ "system" ]) attrs)
-        ../.
+        ../.   # /default.nix
         (import path)
       ];
     };

modules/services/gitea.nix

@@ -9,13 +9,15 @@ in {
   };
 
   config = mkIf cfg.enable {
-    # I prefer git@... ssh addresses over gitea@...
+    # Allows git@... clone addresses rather than gitea@...
     users.users.git = {
       useDefaultShell = true;
       home = "/var/lib/gitea";
       group = "gitea";
     };
 
+    user.extraGroups = [ "gitea" ];
+
     services.gitea = {
       enable = true;
 
@@ -30,8 +32,6 @@ in {
       settings.server.DISABLE_ROUTER_LOG = true;
     };
 
-    user.extraGroups = [ "gitea" ];
-
     services.fail2ban.jails.gitea = ''
       enabled = true
       filter = gitea