Nix

Documentation for Nix, NixOS, and related configuration management used across Bashfulrobot MFG systems.

This section covers NixOS system management, configuration, and deployment processes. All configurations are based on the bashfulrobot/nixcfg repository - a comprehensive NixOS configuration management system.

The nixcfg repository serves as the central configuration hub for all NixOS systems, featuring:

• Declarative System Management - Complete system configurations in code
• Modular Architecture - Reusable modules for different system components
• Multiple System Support - Manages workstations and servers with different profiles
• Automated Bootstrap - Streamlined deployment to new hardware
• Secrets Management - git-crypt integration for sensitive configuration data
• Development Tools - justfile-based workflow automation

• Flake-based Configuration - Modern Nix flakes for dependency management
• Auto-import System - Automatic module discovery and loading
• Hardware Detection - Automatic hardware configuration generation
• Desktop Environment Support - GNOME and Hyprland configurations
• Development Environment - Comprehensive tooling for software development

nixcfg/
├── hosts/           # Host-specific configurations
├── modules/         # Reusable system modules
├── suites/          # Grouped module collections
├── bootstrap/       # Deployment automation
├── settings/        # JSON configuration files
└── justfile         # Build and management commands

See the NixOS Deployment guide for complete installation instructions.

# Navigate to configuration directory
cd ~/dev/nix/nixcfg

# Quick syntax check
just check

# Test configuration
just test  

# Apply changes
just rebuild

The nixcfg approach emphasizes:

• Reproducibility - Identical configurations across deployments
• Modularity - Reusable components for different use cases
• Maintainability - Clear organization and documentation
• Security - Encrypted secrets and secure defaults
• Automation - Minimal manual intervention required

• Main Repository: bashfulrobot/nixcfg
• NixOS Manual: NixOS Documentation
• Nix Language: Nix Expression Language
• Community: NixOS Discourse