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.