Skip to content
Darkone NixOS Framework

Modules

The framework’s features are provided as high-level NixOS modules, grouped by category under dnf/modules/ and documented in the module reference.

Categories

Section titled “Categories”
  • standard — system, console, graphic, service, admin, user.
  • mixin — macro-modules composing host profiles and user-profile add-ons.
  • home — Home Manager 🡕 modules and profiles.

Create a module

Section titled “Create a module”
  1. Choose the category (dnf/modules/standard/<category>/ or mixin).
  2. Write the file header according to the rules (see code headers).
  3. Declare options then the module config.
  4. Regenerate (just generate) and test before committing.

For a self-hosted service (web UI, API, storage…), follow the dedicated guide Create a service module: reverse proxy, persistence, firewall, Kanidm SSO, and per-host activation.