Misterio77/nix-starter-configs
Nix Starter Configs
nix-starter-configs is a collection of boilerplate templates and project structures for initializing reproducible NixOS system configurations and declarative dotfile management. It provides a foundation for managing user-specific applications and settings through a modular Home Manager setup that remains independent of the global system root.
The project utilizes a Nix Flake project structure to lock dependencies and ensure consistent builds across different machines. It includes a package overlay framework and a dedicated system for defining custom software derivations to modify existing package versions within a global search path.
The configuration surface covers the creation of reusable modules, the synchronization of user dotfiles, and the handling of sensitive credentials via external files to prevent secrets from being stored in the public system store.
Features
- Bootstrapping Templates - Offers boilerplate templates for initializing a reproducible NixOS system from scratch.
- System Initialization Templates - Provides comprehensive boilerplate templates for initializing a fully reproducible NixOS system and user environment.
- Package Overrides - Allows overriding default package versions and patching software behavior through custom overlay definitions.
- Dotfile Managers - Provides a version-controlled method for syncing user preferences and configuration files across devices.
- Nix Flake Workflows - Provides a structured Nix Flake layout to ensure consistent builds and dependency locking across different machines.
- Nix Packages - Utilizes a structured Nix Flake project layout to lock dependencies and ensure consistent builds.
- Package Customizations - Allows for the definition and iteration of custom local package derivations used system-wide.
- Overlays - Implements a package overlay framework to modify or replace default software versions in the global search path.
- NixOS User Configurations - Offers dedicated templates for bootstrapping Home Manager to manage user applications and dotfiles.
- User Environment Managers - Provides a modular foundation for managing user-specific packages and dotfiles independently of the system root.
- Module-Based Configurations - Defines reusable configuration modules that can be mixed and matched across various host profiles.
- Dotfile Managers - Implements a version-controlled system for syncing dotfiles and user preferences across multiple devices.
- Initialization Boilerplates - Ships a set of boilerplate files for initializing a reproducible Linux operating system via a declarative approach.
- Lock-File Pinning - Utilizes Nix Flakes to pin exact input versions and ensure consistent builds across different machines.
- Configuration Abstractions - Enables the creation of reusable configuration modules that expose consistent options across different hosts.
- Declarative Home Manager Integrations - Integrates Home Manager to declaratively deploy user-level services and a personalized desktop environment.
- Home Manager Configurations - Provides a modular Home Manager setup for managing user applications and settings independent of the global system root.
- Boilerplate Layouts - Provides a standardized directory structure and boilerplate files for organizing modular NixOS and Home Manager settings.
- Dotfile Symlinking - Synchronizes user dotfiles by mapping repository-managed files to home directory paths.
- Package Overlay Frameworks - Includes a dedicated package overlay framework for modifying existing software versions within a global search path.
- External Secret Resolution - Implements mechanisms to resolve secure configuration values from outside the global system store.
- Out-of-Store Secret Referencing - Handles user secrets by referencing external files to prevent credentials from being stored in the public Nix system store.
- Secret File Loading - Prevents sensitive credentials from entering the public system store by loading them from external local files.
- Configuration Modularization - Organizes configuration by splitting settings into smaller, modular components and a consistent directory structure.
- Learning Resources - Template configurations for getting started with NixOS.
