Contents
Conceptual documentation to help you understand the architecture and design patterns used in this infrastructure.
Overview
Section titled “Overview”- Architecture overview - Understanding the architecture combining deferred module composition, clan, and multi-channel overlay composition
Module system foundations
Section titled “Module system foundations”- Module system primitives - Understanding deferredModule, evalModules, and fixpoint computation - the foundations that enable Nix configuration composition
- Flake-parts and the module system - How flake-parts wraps nixpkgs evalModules to provide flake composition, perSystem evaluation, and namespace conventions
Configuration patterns
Section titled “Configuration patterns”- Deferred module composition - Understanding deferred module composition where every Nix file is a module organized by aspect
- Clan Integration - Multi-machine coordination with clan and clear boundaries with other tools
- System-user integration - Understanding admin users with integrated home-manager vs non-admin standalone users
Build and CI
Section titled “Build and CI”- Build service topology - Two CI build services coexisting on magnetite, and the boundaries that keep them apart
- Darwin build access - How the fleet reaches stibnite’s aarch64-darwin store, and why the remote builder and the remote store are two mechanisms