4
Home
Athenix CI edited this page 2026-01-27 14:28:24 -05:00

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

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: