Configuration Options

This document describes all available configuration options in the Athenix namespace.

Quick Reference

athenix.sw - Software configuration (desktop, headless, kiosk modes)
athenix.users - User account management
athenix.host - Host-specific settings (filesystem, build methods)
athenix.fleet - Fleet inventory definitions
athenix.forUser - Convenience option to enable a user
athenix.system.gc - Garbage collection settings

Detailed Options

For detailed option information, use:

# View all athenix options
nix eval .#nixosConfigurations.nix-desktop1.options.athenix --apply builtins.attrNames

# View specific option description
nix eval .#nixosConfigurations.nix-desktop1.options.athenix.sw.desktop.enable.description

# Export all options to JSON
nix build .#athenix-options
cat result | jq

Software Types

Enable different system configurations:

desktop - Full KDE Plasma desktop environment
headless - Server/container configuration
tablet-kiosk - Touch-optimized kiosk for tablets
stateless-kiosk - Diskless PXE boot kiosk
builders - Build server with optional Gitea Actions runner

See the individual option descriptions for detailed information.