47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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
|
|
└── macos.nix # skyg.user.macos.enableOverride — macOS-only HM tweaks
|
|
```
|
|
|
|
## What lives here
|
|
|
|
- **Overlays** (`default.nix`): exposes the `pkgs/` packages — `grok-cli`, `ds4`
|
|
(+`ds4-rocm`/`ds4-cuda`), `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, flox,
|
|
devenv) and the trusted public keys. Extra entries can be appended per-host via
|
|
`skyg.core.substituters.{urls,keys}`.
|
|
|
|
## 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.
|