From e698b006030c2e2f992c8ebe3e316e4afdebf977 Mon Sep 17 00:00:00 2001
From: hdh20267 <hdh20267@uga.edu>
Date: Thu, 18 Dec 2025 18:31:42 +0000
Subject: [PATCH] Add Troubleshooting

---
 Troubleshooting.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 Troubleshooting.md

diff --git a/Troubleshooting.md b/Troubleshooting.md
new file mode 100644
index 0000000..266b4b0
--- /dev/null
+++ b/Troubleshooting.md
@@ -0,0 +1,32 @@
+# Troubleshooting
+
+This page collects common failure modes and recovery steps.
+
+## Build Failures
+
+Run with full trace:
+
+```bash
+nix flake check --show-trace
+```
+
+## Remote Builder Issues
+
+Verify SSH access and disk space on the builder.
+
+## LXC Console Issues
+
+If the Proxmox console is blank, type blindly or use SSH.
+
+## Disk Space
+
+Clean the Nix store:
+
+```bash
+nix-collect-garbage -d
+nix store optimise
+```
+
+## Boot Failures
+
+Reboot and select a previous generation from the boot menu.