1.6 KiB
1.6 KiB
modules/nixos/
All Linux/NixOS-specific modules, grouped by scope. default.nix simply imports the three
subtrees below; every option here lives under skyg.nixos.* (with a few legacy
skyg.server.* and skyg.core.* exceptions noted in the subfolders).
Structure
nixos/
├── default.nix # imports common/ + server/ + desktop/
├── common/ # Settings every Linux host gets (core, networking, ssh, fonts, hardware…)
├── server/ # Opt-in server roles & services (K3s/K8s, ARRs, DNS, AI, media…)
└── desktop/ # Opt-in desktop: tilers, theming, browsers, crypto wallets, printers…
How it composes
common/is always active (it sets base system options directly, gated only per-feature).server/anddesktop/are large opt-in trees. Most leaf modules do nothing until theirenableoption is set, so importing the whole tree is cheap.- The two top-level gates are
skyg.nixos.desktop.enableand the per-service enables underskyg.nixos.server.*/skyg.server.*.
Option Namespace
skyg.nixos.common.* → common/
skyg.nixos.desktop.* → desktop/
skyg.nixos.server.* → server/ (most services)
skyg.server.* → server/ (arrs, admin, timers, dns — legacy prefix)
skyg.core.qemu.* → common/qemu.nix
Conventions
- New shared Linux behaviour goes in
common/; opt-in roles go inserver/ordesktop/. - Gate everything behind an
enableoption withlib.mkIf cfg.enable { ... }. - Note the naming split: newer server modules use
skyg.nixos.server.*while several older ones useskyg.server.*. Match the surrounding file when extending.