# hosts/ One NixOS configuration file per managed machine, plus hardware configs and host-specific scripts. ## Structure ``` hosts/ ├── .nix # Host configuration (packages, services, options) ├── .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 │ └── functions.nu # NuShell helpers (k8s namespace/secret listing, secret decoding) └── fw1/ └── gs.sh # gamescope/Steam launch wrapper (VRR, HDR, mangoapp overlay) ``` ## 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-pi1.nix` | hl-pi1 | Raspberry Pi CM4 (aarch64) — headless server, SSH only. Also buildable as a bootable SD image via the `hl-pi1-sd-image` nixosConfiguration (`skyg build-pi-sd-image`) | | `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