Changing or Resetting Passwords

The following instructions are for changing or resetting internal admin passwords. This is the password that you need to use to access The Admin Interface. There are three different cases which use two different procedures.

1. I want to change my own password.

1. Log into The Admin Interface
2. Go to Admin > Users (using the left-hand menu bar)
3. Select your username from the list.
4. Near the top of the screen you should see a field 'Password' with a long string of symbols. Just below this you should see a message about how 'you can change the password using this form'. Click on the link to 'this form', then enter your new password.

2. I have forgotten my password, but I know someone else who has 'superuser' admin rights

If you or someone on your project team has an admin account and can access it (i.e. they haven't forgotten their password), or you want to reset the password on behalf of someone else, then you can change your password using the same instructions above. Simply follow the procedure outlined in 'I want to change my own password' above but select the user of the password you want to change.

3. I have forgotten my password and I do not know anyone else with 'superuser' admin rights

The most likely example of this is if you have installed DigiPal using Docker on your own system but have now forgotten your password.

1. First, you need to get access to the Django command line. If you are using Docker and Kitematic then simply click on the 'Exec' button in Kitematic (the one with a '>_' in a circle). If you are not using Kitematic then you must check the documentation for your system or ask your system administrator.
2. If you are using the default Docker setup then you will already be in the right directory so you can skip this step. If you are using another system then you may need to use cd in the command line to change to the top of the DigiPal Django directory. If you type the command ls then you should get a list of files which includes one called manage.py.
3. Now type python manage.py changepassword *username*, replacing *username* with the username of the user whose password you wish to change.
4. You should now see a prompt 'Password:' – enter the new password, and then enter it again when it asks you to verify.
5. Type Ctrl-D to exit the shell, and then close the command line window.