From 1f70e956151266fc98daa1e3f15fb25c950891db Mon Sep 17 00:00:00 2001
From: Quill <69414602+teslazonda@users.noreply.github.com>
Date: Wed, 18 Feb 2026 00:26:59 +0900
Subject: T8081: Update password recovery flow documentation (#1756)

---
 docs/_static/images/password-recovery-01.png  | Bin 26445 -> 0 bytes
 docs/_static/images/reset-password-step-1.jpg | Bin 0 -> 37351 bytes
 docs/_static/images/reset-password-step-2.jpg | Bin 0 -> 42278 bytes
 docs/_static/images/reset-password-step-3.jpg | Bin 0 -> 36932 bytes
 docs/_static/images/reset-password-step-4.jpg | Bin 0 -> 31564 bytes
 docs/_static/images/reset-password-step-5.jpg | Bin 0 -> 100973 bytes
 docs/operation/password-recovery.rst          |  71 ++++++++++++++++----------
 7 files changed, 44 insertions(+), 27 deletions(-)
 delete mode 100644 docs/_static/images/password-recovery-01.png
 create mode 100644 docs/_static/images/reset-password-step-1.jpg
 create mode 100644 docs/_static/images/reset-password-step-2.jpg
 create mode 100644 docs/_static/images/reset-password-step-3.jpg
 create mode 100644 docs/_static/images/reset-password-step-4.jpg
 create mode 100644 docs/_static/images/reset-password-step-5.jpg

(limited to 'docs')

diff --git a/docs/_static/images/password-recovery-01.png b/docs/_static/images/password-recovery-01.png
deleted file mode 100644
index 345ca357..00000000
Binary files a/docs/_static/images/password-recovery-01.png and /dev/null differ
diff --git a/docs/_static/images/reset-password-step-1.jpg b/docs/_static/images/reset-password-step-1.jpg
new file mode 100644
index 00000000..3b6f7703
Binary files /dev/null and b/docs/_static/images/reset-password-step-1.jpg differ
diff --git a/docs/_static/images/reset-password-step-2.jpg b/docs/_static/images/reset-password-step-2.jpg
new file mode 100644
index 00000000..265bc73b
Binary files /dev/null and b/docs/_static/images/reset-password-step-2.jpg differ
diff --git a/docs/_static/images/reset-password-step-3.jpg b/docs/_static/images/reset-password-step-3.jpg
new file mode 100644
index 00000000..98795757
Binary files /dev/null and b/docs/_static/images/reset-password-step-3.jpg differ
diff --git a/docs/_static/images/reset-password-step-4.jpg b/docs/_static/images/reset-password-step-4.jpg
new file mode 100644
index 00000000..6f70ea24
Binary files /dev/null and b/docs/_static/images/reset-password-step-4.jpg differ
diff --git a/docs/_static/images/reset-password-step-5.jpg b/docs/_static/images/reset-password-step-5.jpg
new file mode 100644
index 00000000..70c586e2
Binary files /dev/null and b/docs/_static/images/reset-password-step-5.jpg differ
diff --git a/docs/operation/password-recovery.rst b/docs/operation/password-recovery.rst
index e0c4fda5..ad5d90de 100755
--- a/docs/operation/password-recovery.rst
+++ b/docs/operation/password-recovery.rst
@@ -1,27 +1,44 @@
-:lastproofread: 2025-11-19
-
-.. _password-recovery:
-
-#################
-Password Recovery
-#################
-
-Using the console, restart the VyOS router. The GRUB menu appears.
-Select the relevant option from the GRUB menu, then press **Enter**.
-The option must begin with *Lost password change.*
-
-.. figure:: /_static/images/password-recovery-01.png
-   :width: 600
-
-The stand-alone user-password recovery tool runs and prompts you to reset the
-local system user password.
-
-.. code-block:: console
-
-   Do you wish to reset the admin password? (y or n) 
-   y
-   Which admin account do you want to reset?[vyos]
-   my_username
-   Enter my_username password: 
-   Retype my_username password: 
-   System will reboot in 10 seconds...
+:lastproofread: 2026-02-04
+
+.. _password-recovery:
+
+#################
+Password Recovery
+#################
+
+Restart VyOS from the console. The GRUB menu appears.
+Select **Boot options**.
+
+.. figure:: /_static/images/reset-password-step-1.jpg
+   :width: 600
+
+
+Next, select **Select boot mode**.
+
+.. figure:: /_static/images/reset-password-step-2.jpg
+   :width: 600
+
+Select **Password reset**.
+
+.. figure:: /_static/images/reset-password-step-3.jpg
+   :width: 600
+
+Boot the desired VyOS version.
+
+.. figure:: /_static/images/reset-password-step-4.jpg
+   :width: 600
+
+The standalone user password recovery tool runs and prompts you to reset the
+local system user password. VyOS automatically reboots after you reset your
+password.
+
+
+.. code-block:: console
+
+   Do you wish to reset the admin password? (y or n)
+   y
+   Which admin account do you want to reset?[vyos]
+   my_username
+   Enter my_username password:
+   Retype my_username password:
+   System will reboot in 10 seconds...
-- 
cgit v1.2.3