Files
nixos-setup/hosts/ABOUTME.md
T
2026-11-05 15:21:01 -05:00

5.3 KiB

hosts/

One folder per managed machine, plus hardware configs and host-specific scripts.

Structure

hosts/
├── <hostname>/                    # 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
├── <hostname>.hardware-configuration.nix  # Generated — DO NOT EDIT
├── <hostname>.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); nbot master
hl-fws1/ hl-fws1 Framework 11th Intel — K3s server node; nbot worker
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 <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

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