From 2754a814b9e0a244117c9ddb7371ce3590bfe1d0 Mon Sep 17 00:00:00 2001 From: yuvipanda Date: Tue, 4 Sep 2018 12:35:30 -0700 Subject: [PATCH] Add documentation on resetting user passwords --- docs/howto/auth/firstuse.rst | 34 ++++++++++++++++++++++ docs/images/auth/firstuse/delete-user.png | Bin 0 -> 7320 bytes 2 files changed, 34 insertions(+) create mode 100644 docs/images/auth/firstuse/delete-user.png diff --git a/docs/howto/auth/firstuse.rst b/docs/howto/auth/firstuse.rst index dc9dcb9..f075b7f 100644 --- a/docs/howto/auth/firstuse.rst +++ b/docs/howto/auth/firstuse.rst @@ -34,3 +34,37 @@ the JupyterHub, run the following command. tljh-config set auth.FirstUseAuthenticator.create_users true tljh-config reload + + +Resetting user password +======================= + +You can reset user passwords by *deleting* the user from the JupyterHub admin +page. This logs the user out, but does **not** remove any of their data or +home directories. The user can then set a new password by logging in again with +their new password. + +#. As an admin user, open the **Control Panel** by clicking the control panel + button on the top right of your JupyterHub. + + .. image:: ../images/control-panel-button.png + :alt: Control panel button in notebook, top right + +#. In the control panel, open the **Admin** link in the top left. + + .. image:: ../images/admin/admin-access-button.png + :alt: Admin button in control panel, top left + + This opens up the JupyterHub admin page, where you can add / delete users, + start / stop peoples' servers and see who is online. + +#. **Delete** the user whose password needs resetting. Remember this **does not** + delete their data or home directory. + + .. image:: ../images/auth/firstuse/delete-user.png + :alt: Delete user button for each user + + If there is a confirmation dialog, confirm the deletion. This will also log the + user out if they were currently running. + +#. Ask the user to log in again with their new password as usual. \ No newline at end of file diff --git a/docs/images/auth/firstuse/delete-user.png b/docs/images/auth/firstuse/delete-user.png new file mode 100644 index 0000000000000000000000000000000000000000..9d60279f91f7b6764981d72a95af25e77f4ec3c9 GIT binary patch literal 7320 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