some documentation I wrote without proofreading at 2 in the morning

@@ -4,0 +26,4 @@
+└───packages
+    └───x86_64-linux
+```
+we can see there is an output called `nixosConfigurations.nyarlathotep`. Which contains the configuration of the machine

@@ -10,0 +57,4 @@
+```
+$ nix copy -s --to <however you setup your ssh stuff> .#nixosConfigurations.<name>.config.system.build.toplevel
+```
+This will evaluate the flake again to get the store path of the given derivation. If we want to avoid this

@@ -10,0 +60,4 @@
+This will evaluate the flake again to get the store path of the given derivation. If we want to avoid this
+we might supply the corresponding store path directly.
+
+The `-s` is important it makes the target machine substitute all derivations it can (by default from chache.nixos.org).

@@ -10,0 +79,4 @@
+is exactly the same it was on your machine.
+
+
+If you have a `nixos-rebuild` available on your system it can automatize these things with the `--flake` and

@@ -12,2 +86,2 @@
-clone this repo to `/etc/nixos/` and `nixos-rebuild` that will select
-the appropriate machine based on hostname
+
+clone this repository to `/etc/nixos/` and `nixos-rebuild boot` or `nixos-rebuild switch` that will select

@@ -14,0 +87,4 @@
+clone this repository to `/etc/nixos/` and `nixos-rebuild boot` or `nixos-rebuild switch` that will select
+the appropriate machine based on hostname.
+
+If the hostname is not correct, or you don't want to clone this flake you can also use the `--flake` parameter.

@@ -15,2 +141,3 @@
 
-### sops
+## How to write a new machine configuration
+At best you take a first look at already existing configurations. But here are a few guidelines.

@@ -17,0 +163,4 @@
+  system.stateVersion = "<state version at time of install>";
+}
+```
+the import of `../../roles` loads all the nice default setup that all these machines have in common. There the

@@ -17,0 +171,4 @@
+is already taken care of by `../../roles`.
+
+As of moment of writing `network.nix` should contain ip, nameserver and default gateway setup. As parts of
+this is constant across all systems this will undergo refactor soon.

@@ -17,0 +173,4 @@
+As of moment of writing `network.nix` should contain ip, nameserver and default gateway setup. As parts of
+this is constant across all systems this will undergo refactor soon.
+
+I would recommend to split your configuration into small files you import. If this is something machine specific (like

@@ -17,0 +174,4 @@
+this is constant across all systems this will undergo refactor soon.
+
+I would recommend to split your configuration into small files you import. If this is something machine specific (like
+tied to your ip address hostname) put it into the machine directory. If it is not put it into `/nixos/roles/` if it

@@ -17,0 +198,4 @@
+network configuration. And service configuration that are too closely interwoven with the rest of that machine (for example
+mailserver configuration depends heavily on network settings). It also
+contains the root configuration for that machine called `configuration.nix`. This file usually only includes other modules.
+These `configuration.nix` files are almost usual nix configurations. The only difference is, that they take as an extra argument

@@ -17,0 +199,4 @@
+mailserver configuration depends heavily on network settings). It also
+contains the root configuration for that machine called `configuration.nix`. This file usually only includes other modules.
+These `configuration.nix` files are almost usual nix configurations. The only difference is, that they take as an extra argument
+the flake inputs. This allows them to load modules from these flakes. For example nyarlathotep loads the simple-nixos-mailserver

@@ -4,0 +6,4 @@
+most appropriate depends on the context and scenario. So first there will be a general
+explanation how this works and afterwards we will talk about some scenarios.
+
+If you run `nix flake show` you should get an output similar to this

@@ -7,0 +43,4 @@
+And so on...
+
+#### Build
+If you have this repository local in your current directory you can just run

@@ -14,0 +134,4 @@
+nixos-install --flake 'git+https://gitea.mathebau.de/Fachschaft/nixConfig?ref=<branchname>#<name>'
+```
+where `<branchname>` is the branch you install from and `<name>` is the name of the configuration you build.
+If the build system is already in the nix store this will start the installation, else it will first attempt to build