diff --git a/README.md b/README.md
index 3748378..3ebd9b5 100644
--- a/README.md
+++ b/README.md
@@ -25,3 +25,14 @@ Everything is symlinked into `~/.config` via `install.sh`, with packages listed
 git clone git@github.com:YOURNAME/dotfiles.git
 cd dotfiles
 ./install.sh
+```
+
+### One-time hibernation enablement
+
+Hibernation requires a persistent swap file, kernel resume parameters, and a regenerated UKI. Run once, then reboot:
+
+```bash
+sudo bash scripts/enable-hibernation.sh
+```
+
+After reboot, `systemctl hibernate` will work, and lid close / 30-min idle will suspend-then-hibernate per the tracked logind config.