37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
# hosts/
|
|
|
|
One NixOS configuration file per managed machine, plus hardware configs and host-specific scripts.
|
|
|
|
## Structure
|
|
|
|
```
|
|
hosts/
|
|
├── <hostname>.nix # Host configuration (packages, services, options)
|
|
├── <hostname>.hardware-configuration.nix # Generated by nixos-generate-config — DO NOT EDIT
|
|
├── scripts/
|
|
│ └── fwbook/ # fwbook-specific shell scripts
|
|
│ └── functions.sh # ZSH functions sourced at shell startup
|
|
```
|
|
|
|
## Managed Hosts
|
|
|
|
| File | Host | Role |
|
|
|---|---|---|
|
|
| `fwbook.nix` | fwbook | Framework 13 AMD — personal laptop / daily driver |
|
|
| `hl-fwdesk.nix` | hl-fwdesk | Framework Desktop AI Max 300 — AI workstation |
|
|
| `hl-fws1.nix` | hl-fws1 | Framework 11th Intel — K3s server node |
|
|
| `hl-bigbox1.nix` | hl-bigbox1 | AI/compute server (NVIDIA + AMD) |
|
|
| `hl-bigbox2.nix` | hl-bigbox2 | NFS storage server |
|
|
| `hl-minipc1.nix` | hl-minipc1 | Core infra: Gitea, nix-serve, Docker registry |
|
|
| `hl-minipc2.nix` | hl-minipc2 | Container/media server |
|
|
| `hl-minipc3.nix` | hl-minipc3 | K3s worker node |
|
|
| `hl-terra1.nix` | hl-terra1 | NFS storage + Jellyfin backup |
|
|
| `iso.nix` | iso | Bootable NixOS installer image |
|
|
|
|
## Rules
|
|
|
|
- **Do not add `imports = [...]`** to host files — module composition happens in `flake.nix` via `modules/main.nix`
|
|
- **Do not edit `*.hardware-configuration.nix`** — these are generated and will be overwritten
|
|
- Host-specific packages and one-off settings belong here; anything reused across hosts belongs in `modules/`
|
|
- See `docs/hosts/README.md` for full per-host service/port/package reference
|