1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
|
# NixOS Configuration
A modular NixOS flake configuration for managing multiple machines (kronos, herra, mystra) with a layered architecture and swappable desktop rices.
## Quick Start
```bash
# Apply configuration
sudo nixos-rebuild switch
# Build for specific host
sudo nixos-rebuild switch --flake .#kronos
sudo nixos-rebuild switch --flake .#herra
sudo nixos-rebuild switch --flake .#mystra
# Test without applying
sudo nixos-rebuild test
# Validate syntax
nix flake check
# Preview changes
sudo nixos-rebuild dry-run
# Update flake inputs
nix flake update
```
## Architecture
```
flake.nix # Entry point - assigns rices to hosts
↓
hosts/{kronos,herra,mystra}/ # Per-machine configs
├─ configuration.nix # Machine identity + overrides
└─ hardware-configuration.nix # Hardware (autogenerated)
system/ # System-wide base config
└─ default.nix # Orchestrator (base modules only)
├─ boot.nix, audio.nix, bluetooth.nix
├─ networking.nix, graphics.nix
├─ packages.nix, programs.nix, services.nix
└─ users.nix, nix.nix
home/rices/{rice}/ # Rice configs (self-contained)
├─ default.nix # Exports {system, home}
├─ system.nix # NixOS: Desktop + Stylix
└─ home.nix # HM: imports program configs
home/mun/ # User "mun" config
└─ default.nix # User orchestrator
└─ programs/ # git, ssh, zsh
home/rices/ # Desktop rices
├─ nord-blue/ # Complete rice (i3wm)
├─ original/ # Complete rice (i3wm)
├─ schrottkatze/ # Complete rice I borrowed from Schrottkatze's config (niri)
└─ cinnamon/ # Complete rice (Cinnamon)
```
## Directory Structure
```
.
├── flake.nix # Flake inputs/outputs
├── flake.lock # Reproducibility lock
│
├── hosts/
│ ├── kronos/ # Machine 1
│ │ ├── configuration.nix
│ │ └── hardware-configuration.nix
│ ├── herra/ # Machine 2 (desktop, dual-boot, Zen kernel)
│ │ ├── configuration.nix
│ │ ├── hardware-configuration.nix
│ │ ├── packages.nix
│ │ ├── audio.nix
│ │ └── drivers.nix
│ └── mystra/ # Machine 3
│ ├── configuration.nix
│ └── hardware-configuration.nix
│
├── system/ # System-wide base modules
│ ├── default.nix # Imports all base system modules
│ ├── nix.nix # Nix settings, flakes
│ ├── boot.nix # Bootloader, kernel
│ ├── audio.nix # Pipewire
│ ├── bluetooth.nix # Bluetooth
│ ├── networking.nix # NetworkManager
│ ├── graphics.nix # GPU drivers
│ ├── packages.nix # System packages
│ ├── programs.nix # System programs
│ ├── services.nix # System services
│ └── users.nix # User accounts
│
└── home/
├── mun/ # User "mun"
│ ├── default.nix # User orchestrator
│ └── programs/
│ ├── git.nix
│ ├── ssh.nix
│ └── zsh.nix
│
└── rices/ # Desktop themes
├── nord-blue/ # Complete rice (i3wm)
│ ├── default.nix # Exports {system, home}
│ ├── system.nix # NixOS: Desktop + stylix
│ ├── home.nix # HM: imports all configs
│ ├── i3.nix
│ ├── alacritty.nix
│ ├── nvim.nix
│ ├── helix.nix
│ ├── picom.nix
│ └── fastfetch.nix
│
├── original/ # Complete rice (i3wm)
│ ├── default.nix # Exports {system, home}
│ ├── system.nix # NixOS: Desktop + stylix
│ ├── home.nix # HM: imports all configs
│ ├── variables.nix # Color definitions
│ ├── i3.nix
│ ├── kitty.nix
│ ├── polybar.nix
│ ├── rofi.nix
│ ├── dunst.nix
│ ├── neovim.nix
│ ├── nnn.nix
│ ├── picom.nix
│ ├── scripts.nix
│ └── xdg.nix
│
└── plasma6/ # Complete rice (KDE Plasma)
├── default.nix # Exports {system, home}
├── system.nix # NixOS: Plasma + stylix
├── home.nix # HM: Plasma configs
└── variables.nix # Wallpaper path
```
## Configuration Layers
### 1. System Layer (`system/`)
Base system config applied to all machines: boot, networking, audio, graphics, packages, services, users. Does NOT include desktop or stylix (moved to rice layer).
### 2. Machine Layer (`hosts/`)
Per-machine identity (hostname), hardware configuration, and optional machine-specific overrides (e.g., herra uses Zen kernel).
### 3. Rice Layer (`home/rices/*/`)
Self-contained desktop environment configs. Each rice exports `{system, home}`:
- **system.nix**: NixOS-level (desktop environment, system packages, stylix theming)
- **home.nix**: Home-manager level (imports program configs like i3, terminal, editor)
- **default.nix**: Exports both modules for flake consumption
### 4. User Layer (`home/mun/`)
User-specific shared programs: git, ssh, zsh config. Only contains configs shared across all rices.
## Adding Configurations
**New system package:**
```nix
# system/packages.nix
environment.systemPackages = with pkgs; [
# add here
];
```
**New system module:**
1. Create `system/mymodule.nix`
2. Add to `system/default.nix` imports
**New user program:**
1. Create `home/mun/programs/myprogram.nix`
2. Add to `home/mun/default.nix` imports
**New rice module:**
1. Create file in target rice directory (e.g., `home/rices/nord-blue/mymodule.nix`)
2. Add to that rice's `home.nix` imports
## Switching Rices
Rices are assigned per-host in `flake.nix`. Edit the `nixosConfigurations` section:
```nix
nixosConfigurations = {
kronos = mkSystem "kronos" "nord-blue"; # Laptop uses nord-blue
herra = mkSystem "herra" "plasma6"; # Desktop uses plasma6
mystra = mkSystem "mystra" "nord-blue"; # Another machine uses nord-blue
};
```
Then rebuild: `sudo nixos-rebuild switch`
Each rice exports `{system, home}` from its `default.nix`:
1. **system**: Imported by `mkSystem` (NixOS modules - desktop, stylix)
2. **home**: Imported by `mkHomeManagerModule` (HM modules - program configs)
## Creating a New Rice
1. Create directory: `home/rices/my-rice/`
2. Create `system.nix` with NixOS-level configs:
```nix
{pkgs, ...}: {
services.xserver = {
enable = true;
windowManager.i3.enable = true;
# ... desktop environment config
};
stylix = {
enable = true;
# ... theming config
};
}
```
3. Create `home.nix` with home-manager imports:
```nix
{...}: {
imports = [
./i3.nix
./terminal.nix
./editor.nix
# ... program configs
];
}
```
4. Create `default.nix` to export both modules:
```nix
{
system = import ./system.nix;
home = import ./home.nix;
}
```
5. Add application configs (i3.nix, terminal, editor, etc.)
6. Optional: Create `variables.nix` for shared variables
7. Assign to host in `flake.nix`: `myhost = mkSystem "myhost" "my-rice";`
## Machine-Specific Config
Each host has minimal configuration - hostname, hardware, and optional overrides:
```nix
# hosts/kronos/configuration.nix (minimal)
{
imports = [ ./hardware-configuration.nix ];
networking.hostName = "kronos";
}
# hosts/herra/configuration.nix (with overrides)
{
imports = [
./hardware-configuration.nix
./packages.nix
./audio.nix
./drivers.nix
];
networking.hostName = "herra";
boot.loader.grub.useOSProber = true; # Dual-boot with Windows
boot.kernelPackages = lib.mkForce pkgs.linuxPackages_zen; # Gaming kernel
}
```
All shared config lives in `system/` and `home/`.
## Flake Inputs
- `nixpkgs` - NixOS 25.11 (stable)
- `nixpkgs-unstable` - Rolling release, accessible via `pkgs.unstable.*`
- `home-manager` - 25.11 (user environment manager)
- `stylix` - System-wide theming framework (base16 colors, fonts, cursor)
- `fenix` - Rust toolchain manager (provides latest stable/nightly Rust)
- `crane` - Nix build system for Rust projects
|
