diff --git a/content/docs/manage/clients/platforms/mac.mdx b/content/docs/manage/clients/platforms/mac.mdx
index 6afa87b..ff90140 100644
--- a/content/docs/manage/clients/platforms/mac.mdx
+++ b/content/docs/manage/clients/platforms/mac.mdx
@@ -132,9 +132,11 @@ On Mac, the Pangolin GUI reads configuration from `~/Library/Application Support
 
 ### Automatic Updates
 
-The Mac client periodically checks for updates in the background. When an update is available, it requests permission to update. You can also check for updates from the menu bar, or by restarting the application.
+The Mac client checks for updates in the background. The second time you open Pangolin, it asks whether to keep checking automatically. You can also check from the menu bar: **More** > **Check for Updates…**.
 
-Once you accept the update, the client downloads the latest version and replaces itself.
+When an update is available, Pangolin shows a dialog and asks to install it. After you accept, it downloads the new version and installs it.
+
+Automatic installation can be turned on from that dialog, or by setting `autoDownloadUpdatesEnabled` to `true` in the [config file](#config-file). Pangolin then downloads the update in the background while you keep using the current version. The update installs the next time you quit Pangolin, and the app opens again on the new version. If Pangolin stays open for about a week with an update already downloaded, it asks you to install that update.
 
 ### Manual Updates
 
diff --git a/content/docs/manage/clients/platforms/windows.mdx b/content/docs/manage/clients/platforms/windows.mdx
index 53b4da8..b4c116d 100644
--- a/content/docs/manage/clients/platforms/windows.mdx
+++ b/content/docs/manage/clients/platforms/windows.mdx
@@ -162,9 +162,11 @@ As a system administrator, you can script placing `pangolin.json` in `%ProgramDa
 
 ### Automatic Updates
 
-The Windows client periodically checks for updates in the background. When an update is available, it requests permission to update. You can also check for updates from the system tray menu, or by restarting the application.
+The Windows client checks for updates automatically in the background. When a new version is available, Pangolin shows a notification and adds **Pangolin Update Available…** to the system tray menu. Open the notification or that menu item to see a dialog asking whether to install the update now.
 
-Once you accept the update, the client downloads the latest version and replaces itself.
+**Install Update** downloads the new version and installs it. Pangolin restarts when the installation finishes, and the tunnel disconnects briefly while that happens. **Later** closes the dialog and leaves the current version in place.
+
+You can also check from the system tray: **More** > **Check for Updates…**.
 
 ### Manual Updates