26 lines
1 KiB
Markdown
26 lines
1 KiB
Markdown
|
# 💻 Hosts
|
||
|
|
|
||
|
|
This directory contains the entry points for different NixOS system configurations. Each host represents a complete system configuration, combining NixOS system settings and Home Manager configurations.
|
||
|
|
|
||
|
|
## Components
|
||
|
|
|
||
|
|
### default.nix
|
||
|
|
|
||
|
|
The `default.nix` file in each host directory serves as the main entry point for the system configuration. It:
|
||
|
|
|
||
|
|
- Sets up NixOS configurations
|
||
|
|
- Sets up Home Manager configurations
|
||
|
|
- References host-specific module declarations
|
||
|
|
|
||
|
|
### modules/
|
||
|
|
|
||
|
|
The `modules/` directory contains host-specific declarations for custom modules that are defined in the flake's `nixosModules` output. This so far only includes global theme / style related declarations.
|
||
|
|
|
||
|
|
## Adding a New Host
|
||
|
|
|
||
|
|
1. Create a new directory for the host
|
||
|
|
2. Add a `hardware-configuration.nix` generated with `nixos-generate-config`
|
||
|
|
3. Add a `default.nix` that imports the desired configurations
|
||
|
|
4. Create host-specific module declarations in the `modules/` subdirectory to customize the global modules as needed
|
||
|
|
5. Reference the new host in `hosts/default.nix`
|