Files
nixos-setup/modules/ABOUTME.md
T
2026-09-05 14:01:38 -04:00

2.0 KiB

modules/

All reusable NixOS and Home Manager modules. Every host gets the full module tree via modules/main.nix, which is wired up in flake.nix through the makeNixOs helper.

Structure

modules/
├── lib.nix            # makeNixOs / makeIso / makeHomeManagerUsers / makeDarwinModule / eachSystem
│                      #   (registers the `tether` flake input's NixOS module → programs.tether.*)
├── main.nix           # Base module imported by every host: core/ + nixos/ + network-drives.nix
├── skyg-utils.nix     # makeHyperlinkScriptToConfigs (symlinks configs/ → ~/.config/)
├── macos.nix          # macOS / nix-darwin module
├── network-drives.nix # skyg.networkDrives — NFS automount options
├── core/              # User, binary caches, distributed builds, macOS workarounds
├── home/              # Home Manager: shell, programs, git, fonts, services
├── nixos/
│   ├── common/        # Core system settings, networking, SSH, QEMU, fonts, hardware
│   ├── server/        # Server services: K3s/K8s, DNS, AI stack, ARRs, media…
│   └── desktop/       # Desktop: tiler (niri/hyprland), packages, theming, crypto
└── openwrt/           # OpenWrt router config generator

Option Namespace

All custom options live under skyg.*. Never introduce options outside this namespace.

skyg.user.*               → core/user.nix
skyg.networkDrives.*      → network-drives.nix
skyg.rootDir              → core/default.nix (set by the flake; repo root store path)
skyg.nixos.common.*       → nixos/common/
skyg.nixos.desktop.*      → nixos/desktop/
skyg.nixos.server.*       → nixos/server/
skyg.core.*               → core/

Key Conventions

  • All modules gate config with lib.mkIf cfg.enable { ... }
  • Default for every enable option is false unless universally required
  • New modules go in the most specific subdirectory that matches their scope
  • See docs/modules/README.md for full option reference and architecture diagram