Skip to main content

LibreChat is joining ClickHouse. Learn more

LibreChat

Password Reset

Let users reset a forgotten password through an emailed link.

Password reset lets a user pick a new password without asking an admin. It is off by default, and it only makes sense once the server can send email.

The Reset your password page with an Email address field, a Continue button, and a Back to Login linkThe Reset your password page with an Email address field, a Continue button, and a Back to Login link

Resetting a password

On the login page, click Forgot Password?.
Enter the account's email address and click Continue. The page always answers with the same "If an account with that email exists..." message, so it does not reveal which addresses have accounts.
Open the email and follow the link. It is valid for 15 minutes, and requesting a new one invalidates the old one.
Enter and confirm the new password. You then see Password Reset Success and can sign in with it.

A successful reset signs the account out of every other session and revokes its tokens. If email is configured, the user also gets a confirmation email.

Limits

  • Requests are rate limited per IP (2 every 2 minutes by default), and the link submissions are limited separately.
  • If the admin restricted registration to certain email domains, addresses outside those domains cannot request a reset.

Do not enable it without email

Password reset requires configured email delivery. The page never displays reset credentials. Unknown accounts, missing email configuration, and delivery failures receive the same generic acknowledgment, so the acknowledgment does not confirm that a reset email was sent.

Setup

An admin enables it with ALLOW_PASSWORD_RESET and configures Mailgun or an SMTP server. See Email setup; the rate limits are on the Automated Moderation configuration page.

How is this guide?