T8081: Update password recovery flow documentation #1756

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open

teslazonda wants to merge 1 commit into vyos:current from teslazonda:update-password-recovery-flow

docs/_static/images/password-recovery-01.png

Binary file not shown.

docs/_static/images/reset-password-step-1.jpg

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

docs/_static/images/reset-password-step-2.jpg

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

docs/_static/images/reset-password-step-3.jpg

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

docs/_static/images/reset-password-step-4.jpg

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

docs/_static/images/reset-password-step-5.jpg

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

docs/operation/password-recovery.rst

-Original file line number
+Diff line change
@@ -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...