# hosts/ One folder per managed machine, plus hardware configs and host-specific scripts. ## Structure ``` hosts/ ├── / # Per-host folder (default.nix is the entry point) │ ├── default.nix # Main config: skyg options, top-level settings │ ├── packages.nix # environment.systemPackages (large hosts only) │ ├── services.nix # Service configs (tailscale, ollama, steam, …) │ ├── hardware.nix # Kernel params, GPU tuning, boot (large hosts only) │ ├── networking.nix # Firewall, NFS mounts, DNS (large hosts only) │ ├── containers.nix # Container service groups (hl-minipc1, hl-minipc2) │ └── ... # Additional host-specific sub-files as needed ├── .hardware-configuration.nix # Generated — DO NOT EDIT ├── .disko.nix # Declarative disk layout (hl-fws1 only) └── scripts/ ├── fwbook/ # fwbook-specific shell scripts │ ├── functions.sh # ZSH functions sourced at shell startup │ └── functions.nu # NuShell helpers ├── fw1/ │ └── gs.sh # gamescope/Steam launch wrapper └── hl-minipc1/ └── buzz-manage.sh # Buzz stack management CLI ``` ## Managed Hosts | Folder | Host | Role | | ------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `fwbook/` | fwbook | Framework 13 AMD — personal laptop / daily driver | | `hl-fwdesk/` | hl-fwdesk | Framework Desktop AI Max 300 — AI workstation; buildbot-nix CI worker (4 cores) | | `hl-fws1/` | hl-fws1 | Framework 11th Intel — K3s server node | | `hl-bigbox1/` | hl-bigbox1 | AI/compute server (NVIDIA + AMD); Immich machine-learning (CUDA) | | `hl-bigbox2/` | hl-bigbox2 | NFS storage server; Immich server/db (docker, `immich.home.sosnovsky.ca`) | | `hl-minipc1/` | hl-minipc1 | Core infra: Gitea (native or containerized), nix-serve, registry, Buzz (docker, `buzz-manage` CLI), monitoring (Grafana, Prometheus, Loki, OTel collector) | | `hl-minipc2/` | hl-minipc2 | Container/media server | | `hl-minipc3/` | hl-minipc3 | K3s worker node; central Caddy reverse-proxy (`*.home.sosnovsky.ca`, plus `gitea.skyg.ca` HTTP/SSH); buildbot-nix CI master + worker (2 cores) | | `hl-pi1/` | hl-pi1 | Raspberry Pi CM4 (aarch64) — headless server, SSH only | | `hl-pi2/` | hl-pi2 | Raspberry Pi 4 (aarch64) — headless server, SSH only | | `hl-terra1/` | hl-terra1 | NFS storage + Jellyfin backup | | `iso/` | 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 - Hosts with a `.disko.nix` own their `fileSystems` via disko; if a generated `hardware-configuration.nix` still contains its own `fileSystems` stanzas for the same host, that's a conflict the machine's owner needs to resolve by hand (regenerating or trimming it) — not something to script around - 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 ## 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 - Hosts with a `.disko.nix` own their `fileSystems` via disko; if a generated `hardware-configuration.nix` still contains its own `fileSystems` stanzas for the same host, that's a conflict the machine's owner needs to resolve by hand (regenerating or trimming it) — not something to script around - 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