Files
nixos-setup/hosts/ABOUTME.md
T
2026-09-09 14:48:56 -04:00

2.8 KiB

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
├── <hostname>.disko.nix                 # Optional: declarative disk layout for `skyg remote install` (nixos-anywhere).
│                                         # Only present for hosts installed/reinstalled this way (currently: hl-fws1)
└── 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-pi2.nix hl-pi2 Raspberry Pi 4 (aarch64) — headless server, SSH only. Also buildable as a bootable SD image via the hl-pi2-sd-image nixosConfiguration
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
  • Hosts with a <hostname>.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