Contents
Task-oriented guides for common operations and workflows with this infrastructure.
Orientation
Section titled “Orientation”- Reading paths - Curated reading sequences through the documentation based on your goals
Setup and Onboarding
Section titled “Setup and Onboarding”- Getting started - Bootstrap Nix and activate your first configuration
- Host onboarding - Add a new darwin (macOS) or NixOS host with platform-specific workflows
- User onboarding - Set up user environments with home-manager
Customization
Section titled “Customization”- Adding custom packages - Create your own package derivations using the pkgs-by-name pattern
Operations and Maintenance
Section titled “Operations and Maintenance”- Secrets management - Manage encrypted secrets with clan vars and legacy sops-nix
- Handling broken packages - Fix broken packages from nixpkgs unstable with surgical stable fallbacks
- MCP servers usage - Configure and use Model Context Protocol servers
Architecture References
Section titled “Architecture References”For understanding the underlying patterns:
- Deferred Module Composition - Module organization pattern
- Clan Integration - Multi-machine coordination and secrets