T8081: Update password recovery flow documentation (#1756)

7 files changed, 44 insertions, 27 deletions

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
--- a/docs/_static/images/password-recovery-01.png
+++ /dev/null
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
--- /dev/null
+++ b/docs/_static/images/reset-password-step-1.jpg
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
--- /dev/null
+++ b/docs/_static/images/reset-password-step-2.jpg
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
--- /dev/null
+++ b/docs/_static/images/reset-password-step-3.jpg
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
--- /dev/null
+++ b/docs/_static/images/reset-password-step-4.jpg
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
--- /dev/null
+++ b/docs/_static/images/reset-password-step-5.jpg
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...