greg/nixos
1
0
Fork 2
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Greg Hellings
2023-12-14 00:59:16 -06:00
parent 2ed4d83132
commit 08e723361a
1 changed files with 5 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+5 -13
View File
@@ -1,3 +1,5 @@
[![built with garnix](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fgarnix.io%2Fapi%2Fbadges%2Fgarnix-io%2Fhello-garnix)](https://garnix.io)
This is a unified repo to contain my personal configurations for NixOS machines. This is a unified repo to contain my personal configurations for NixOS machines.
# How To Use This # How To Use This
@@ -11,22 +13,12 @@ Go through the normal process to setup a NixOS system during installation.
/etc/nixos folder /etc/nixos folder
5. Run the configuration generator. It should only genreate the hardware-configuration.nix 5. Run the configuration generator. It should only genreate the hardware-configuration.nix
file, which this repo gitignores file, which this repo gitignores
6. Symlink the folder for the appropriate host to the location 'host' as such: 6. Create a folder and file with the machine name in `hosts/<machine>/default.nix`
`ln -s hosts/myhost host`. 7. Add `hosts/default.nix` an appropriate entry for the machine you are building
7. Run the nixos installation command 8. Create a file `home/hosts/<machine>/default.nix` with the new machine name as well
# Adding new hosts # Adding new hosts
To add a new host, create a folder in the directory `hosts/` that matches the name of 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 the target system. Each host must contain, minimally, a `default.nix` file that serves
as the basis of configuring that host. 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.