From 3c4fdca21cb2b5bd9c75e2acabfef082f08fb4da Mon Sep 17 00:00:00 2001
From: hdh20267 <hdh20267@uga.edu>
Date: Thu, 18 Dec 2025 18:30:13 +0000
Subject: [PATCH] Add User Management

---
 User-Management.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 User-Management.md

diff --git a/User-Management.md b/User-Management.md
new file mode 100644
index 0000000..c8ea75d
--- /dev/null
+++ b/User-Management.md
@@ -0,0 +1,37 @@
+# User Management
+
+Users are defined in `users.nix` and enabled per-host in `inventory.nix`.
+
+Only `root` and the default lab account are enabled everywhere by default.
+
+## Defining Users
+
+```nix
+athenix.users.myuser = {
+  description = "Full Name";
+  extraGroups = [ "wheel" "networkmanager" ];
+  shell = pkgs.zsh;
+  hashedPassword = "$6$...";
+  opensshKeys = [ "ssh-ed25519 AAAA..." ];
+};
+```
+
+## Enabling Users on Hosts
+
+```nix
+athenix.users.myuser.enable = true;
+```
+
+Or using the convenience option:
+
+```nix
+athenix.forUser = "myuser";
+```
+
+## External User Modules
+
+Users may reference external repositories that contain both user options
+and home-manager configuration.
+
+External user modules are evaluated in both NixOS and home-manager
+contexts.