Files
nixos-setup/modules/core/ABOUTME.md
T
2026-10-21 09:34:30 -04:00

2.6 KiB

modules/core/

Cross-platform base configuration imported by every host (NixOS and macOS) via modules/main.nix. This is where the primary user, Nix binary caches, distributed builds, and a couple of nixpkgs overlays/workarounds live.

Files

core/
├── default.nix          # Entry point: imports the files below + overlays + remote builder
├── user.nix             # skyg.user.* — the human user + Home Manager wiring
├── nix-substituters.nix # skyg.core.substituters.* — binary caches & trusted keys
├── lab-ca.nix           # Fleet-wide trust of the lab internal CA (configs/pki/lab-ca.crt)
└── macos.nix            # skyg.user.macos.enableOverride — macOS-only HM tweaks

What lives here

  • Overlays (default.nix): exposes the pkgs/ packages — grok-cli, colibri (+colibri-rocm), niri-touchscreen-gestures, buzz-desktop, — and patches python3Packages.pipx to skip its flaky install check on nixpkgs 26.05.
  • Distributed builds (default.nix): registers bigbox1.lab.internal and fwdesk.lab.internal as remote x86_64-linux build machines and enables builders-use-substitutes.
  • User (user.nix): defines skyg.user.{name,fullName,email} plus skyg.home-manager.{version,extraImports}. When skyg.user.enable is set it wires up Home Manager for both root and the named user using the functions in modules/home.
  • Substituters (nix-substituters.nix): the standing list of caches (local minipc1 and bigbox2 caches, cache.nixos.org, cachix caches for cuda/cosmic/ai/noctalia/nixarchy, flox, devenv) and the trusted public keys. Extra entries can be appended per-host via skyg.core.substituters.{urls,keys}. Also sets http-connections = 8 and download-attempts = 10 so flaky links (Wi-Fi) don't disable cache.nixos.org mid-build.
  • Lab CA trust (lab-ca.nix): adds configs/pki/lab-ca.crt to security.pki.certificateFiles so every machine trusts the lab internal CA (created by skyg ca init, see configs/pki/ABOUTME.md). Eval fails if the cert file is missing — run skyg ca init before the first rebuild.

Option Namespace

skyg.user.*                  → user.nix (+ macos.nix for the macOS override)
skyg.home-manager.*          → user.nix
skyg.core.substituters.*     → nix-substituters.nix

Conventions

  • skyg.user.enable triggers Home Manager setup and asserts that name, fullName, and email are non-empty.
  • Cache URLs/keys here are global defaults; add host-specific caches through the skyg.core.substituters.{urls,keys} options rather than editing this file.