Improve import process and add README

This commit is contained in:
Gregory Hellings
2022-04-06 10:37:30 -05:00
parent 9f5b11e5e9
commit 9d6d223898
4 changed files with 36 additions and 4 deletions
+32
View File
@@ -0,0 +1,32 @@
This is a unified repo to contain my personal configurations for NixOS machines.
# How To Use This
Go through the normal process to setup a NixOS system during installation.
1. Boot from an appropriate medium
2. Parition the drives
3. Mount them
4. Before you generate out the configuration, clone this repoistory to your
/etc/nixos folder
5. Run the configuration generator. It should only genreate the hardware-configuration.nix
file, which this repo gitignores
6. Symlink the folder for the appropriate host to the location 'host' as such:
`ln -s hosts/myhost host`.
7. Run the nixos installation command
# Adding new hosts
To add a new host, create a folder in the directory `hosts/` that matches the name of
the target system. Each host must contain, minimally, a `default.nix` file that serves
as the basis of configuring that host.
## Profiles
Certain shared characteristics can be created in the `profiles/` folder and included in
a particular host's configuration. For instance, any hosts that are running on a
Raspsberry Pi 4 should include the `profiles/rpi4.nix` file to properly configure things
like the kernel and boot parameters. Since I live in the "America/Chicago" timezone, hosts
that run in my home will also include `profiles/home.nix`. That file will also set the
domain that I use for my hosts at home. This allows shared content to be reused across
multiple machines without the need to repeat it.