From 622b0ef8b88e5f45c3ea1423fe15b705e97498c5 Mon Sep 17 00:00:00 2001
From: funman300 <funman300@gmail.com>
Date: Wed, 13 May 2026 14:53:12 -0700
Subject: [PATCH] docs: document one-time NetworkManager activation

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 3ebd9b5..f5a2d43 100644
--- a/README.md
+++ b/README.md
@@ -36,3 +36,14 @@ 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.
+
+### One-time NetworkManager activation
+
+After `install.sh` deploys the NetworkManager config, swap from `systemd-networkd` to `NetworkManager` (one-time, persistent across reboots):
+
+```bash
+sudo systemctl disable --now systemd-networkd
+sudo systemctl enable --now NetworkManager
+```
+
+Wifi will drop for a few seconds and reconnect via iwd's stored profiles. If reconnection fails, re-enter the wifi password via `nm-applet` (tray icon) or `networkmanager_dmenu` (waybar network widget click).