NixOS Modular Configuration

✨ A modular NixOS configuration with Flakes support
❄️ Snowflake-inspired infrastructure for your systems

---

🚀 Quick Start

Requirements

• NixOS 24.11 (Vicuña) or newer
• Flakes enabled in /etc/nixos/configuration.nix:

  { nix.settings.experimental-features = [ "nix-command" "flakes" ]; }

Initial Setup

# Generate hardware configuration
sudo rm -rf /etc/nixos/*; sudo nixos-generate-config

# Build and activate configuration
sudo nixos-rebuild switch --flake .#$(hostname) --impure

---

📂 Structure

nixcfg/
├── hosts/               # Host-specific configs
│   ├── common/          # 📁 Shared configurations
│   │   ├── base.nix     # 🖥️  Core system settings
│   │   ├── desktop.nix  # 🖥️  GUI/Desktop environment
│   │   └── users.nix    # 👤 User configurations
│   └── <hostname>/      # 💻 Device-specific configs
│       ├── config.nix   # ⚙️  Host settings
│       └── hardware.nix # 🔧 Auto-generated hardware
├── modules/             # 🧩 Reusable service modules
│   ├── docker.nix       # 🐳 Docker configuration
│   └── flatpak.nix      # 📦 Flatpak setup
└── flake.nix            # ❄️  Flakes entry point

---

🔄 Maintenance

Update System Packages

nix flake update
sudo nixos-rebuild switch --flake .#$(hostname) --impure

Garbage Collection

nix-collect-garbage --delete-older-than 15d

Note
The --impure flag is required for proper environment variable handling in flakes

---

✨ Key Features

• 🔄 Automatic Updates: Weekly GC and auto-upgrade
• 🧩 Modular Design: Easy to maintain and extend
• 💻 Multi-Device Support: Share configs between machines
• 🛡️ Reproducible Builds: Fully declarative configuration

---

🛠️ Customization

Create New Module

1. Add modules/new-module.nix
2. Import in host config:

   imports = [ ./modules/new-module.nix ];