Password reset

Reset password by email

You can reset your password by clicking on the forgotten your password? link on the login page. Simply enter your email address, and an email will be sent to that address with a link. Click on that link in the email, and you'll be able to enter a new password.

The above procedure will only work if the server administrator has entered a working email configuration. If that's not the case, the password will need to be reset on the command line by an administrator. Otherwise, the administrator can enable self-service password resets by entering details of a working email server.

Command line password reset

Enter the following command, replacing user@example.com with the email address of the relevant user:

docker compose exec app python manage.py changepassword user@example.com

You will be prompted for a new password, and asked to confirm it by entering it again. The password change will take effect immediately (no restart required).

This approach is recommended only for single-user servers, since the administrator needs to set the password. For security, it is highly recommended to use the reset by email option on multi-user servers.