Athenix - NixOS Fleet Management

Athenix is a NixOS configuration system for managing the UGA Innovation Factory's fleet of devices using Nix flakes and a custom configuration framework.

Quick Start

• Configuration Options - All available athenix.* options
• User Guide - Setting up user accounts and dotfiles
• Building - Creating installers and system images
• Development - Contributing to Athenix

Features

• Inventory-based fleet management - Define entire device fleets in a single file
• Multiple hardware types - Desktops, laptops, Surface tablets, LXC containers, WSL
• Flexible software configurations - Desktop, headless, kiosk, and builder modes
• External module support - Load user dotfiles and system configs from Git repos
• Declarative everything - Reproducible builds with pinned dependencies

Software Types

Enable different system configurations:

• desktop - Full KDE Plasma 6 desktop environment
• headless - Minimal server/container configuration
• tablet-kiosk - Touch-optimized kiosk for Surface tablets
• stateless-kiosk - Diskless PXE boot kiosk
• builders - CI/CD build server with Gitea Actions runner

Hardware Types

• nix-desktop - Desktop workstations
• nix-laptop - Laptop computers
• nix-surface - Microsoft Surface Pro tablets
• nix-lxc - LXC containers (Proxmox)
• nix-wsl - Windows Subsystem for Linux
• nix-ephemeral - Stateless systems (PXE boot)

Documentation

Browse the documentation using the sidebar or start with:

• README - Repository overview and getting started
• Configuration Options - Complete option reference
• Inventory Guide - Managing the device fleet
• External Modules - Using external configurations