holy moly we're almost there

2022-09-19 08:13:50 +10:00
commit 3693732aac
203 changed files with 17247 additions and 0 deletions
@@ -0,0 +1,62 @@
+# Hosts
+
+Nix flakes contain an output called `nixosConfigurations` declaring an
+attribute set of valid NixOS systems. To simplify the management and creation
+of these hosts, devos automatically imports every _.nix_ file inside this
+directory to the mentioned attribute set, applying the projects defaults to
+each. The only hard requirement is that the file contain a valid NixOS module.
+
+As an example, a file `hosts/system.nix` or `hosts/system/default.nix` will
+be available via the flake output `nixosConfigurations.system`. You can have
+as many hosts as you want and all of them will be automatically imported based
+on their name.
+
+For each host, the configuration automatically sets the `networking.hostName`
+attribute to the folder name or name of the file minus the _.nix_ extension. This
+is for convenience, since `nixos-rebuild` automatically searches for a configuration
+matching the current systems hostname if one is not specified explicitly.
+
+You can set channels, systems, and add extra modules to each host by editing the
+`nixos.hosts` argument in flake.nix. This is the perfect place to import
+host specific modules from external sources, such as the
+[nixos-hardware][nixos-hardware] repository.
+
+It is recommended that the host modules only contain configuration information
+specific to a particular piece of hardware. Anything reusable across machines
+is best saved for [profile modules](./profiles.md).
+
+This is a good place to import sets of profiles, called [suites](./suites.md),
+that you intend to use on your machine.
+
+
+## Example
+
+flake.nix:
+```nix
+{
+  nixos = {
+    imports = [ (devos.lib.importHosts ./hosts) ];
+    hosts = {
+      librem = {
+        channelName = "latest";
+        modules = [ nixos-hardware.nixosModules.purism-librem-13v3 ];
+      };
+    };
+  };
+}
+```
+
+hosts/librem.nix:
+```nix
+{ suites, ... }:
+{
+  imports = suites.laptop;
+
+  boot.loader.systemd-boot.enable = true;
+  boot.loader.efi.canTouchEfiVariables = true;
+
+  fileSystems."/" = { device = "/dev/disk/by-label/nixos"; };
+}
+```
+
+[nixos-hardware]: https://github.com/NixOS/nixos-hardware